Documentation – עבודה עם Microsoft Graph Client

Net: יצירת פרויקט במרכז הניהול של Azure Active Directory

Mon, 01 Jan 0001 00:00:00 +0000

פרויקט צריך להיווצר במרכז ניהול Azure Active Directory עבור משתמש בעל חשבון MS Office.

צעדים ליצירת פרויקט במרכז ניהול Azure Active Directory

להלן מדריך שלב‑אחרי‑שלב ליצירת פרויקט במרכז הניהול של Azure Active Directory.

1. עבור ל‑Azure Active Directory והתחבר באמצעות פרטי החשבון של MS Office שלך

Azure Active Directory קישור - https://aad.portal.azure.com/

2. צור יישום Azure AD בתכנית שלך

בחלק השמאלי של הפאנל לחץ על התווית Azure Active Directory. פעולה זו תפתח את לשונית Azure Active Directory. במסך הזה תראה תווית App registrations. זהו נקודת ההתחלה לרישום יישום Azure AD. לשונית זו תאפשר לך ליצור יישום חדש ל‑Azure AD.

לחץ על הכפתור New registration ליצירת אפליקציה חדשה.

3. כעת תראה את לשונית רישום היישום החדש

Name זה יהיה שם האפליקציה שלך.
סוגי חשבונות נתמכים חלק זה יגביל את הגישה.

לחץ על כפתור Register.

4. אתה צריך לראות את לשונית היישומים שנרשמו זה עתה

Application (client) ID מזהה האפליקציה שלך.
Directory (tenant) ID מזהה השוכר של Azure AD.

5. מתן הרשאות ל‑Microsoft Graph API

לחץ על תגית API permissions.

Azure כבר העניקה לך הרשאות מיודרות User.Read עבור היישום שלך. הרשאה זו תאפשר לנו לקרוא מידע על משתמש מחובר. אלו הן הרשאות של Microsoft Graph API, אנו יכולים לקרוא להן גם Scopes.

ההרשאות המלאות עבור Microsoft Graph API - https://learn.microsoft.com/en-us/graph/permissions-reference.

לחץ על כפתור + Add a permission ובחר Microsoft Graph.

לחץ על Delegated permissions. כעת אתה רואה רשימת הרשאות זמינות ל-API של Microsoft Graph.

בחר את ההרשאות הדרושות, לחץ על כפתור Add permissions.

לחץ על כפתור Grant admin consent.

6. אפשר זרימות של לקוח ציבורי

מציין האם האפליקציה היא לקוח ציבורי. מתאים לאפליקציות המשתמשות בזרימות הענקת אסימונים שאינן משתמשות ב-Redirect URI.

7. יצירת מפתח עבור האפליקציה

Net: אימות Microsoft Graph עם MSAL (Aspose.Email)

Mon, 01 Jan 0001 00:00:00 +0000

מבוא לאימות Graph

Microsoft Graph הוא API REST מאוחד לגישה לנתונים בשירותי Microsoft 365 כגון Outlook, OneDrive ו-Teams. Aspose.Email ל‑.NET מספק מובנה IGraphClient ממשק שמפשט את האינטראקציה עם Microsoft Graph על‑ידי הצעת API ברמת גבוה ובסוגיות חזקות.

שימוש ב‑ IGraphClient, ניתן לאמת באמצעות MSAL, ולאחר מכן לבצע פעולות נפוצות כגון:

ניהול תיקיות דואר (רשימה, יצירה, עדכון, העתקה, מחיקה)
עבודה עם הודעות וקבצים מצורפים (קריאה, שליחה, העברה ושינוי תוכן)
גישה וניהול אירועי לוח שנה, אנשי קשר, קטגוריות, חוקים, משימות ופנקסי OneNote

הדוגמאות הבאות מציגות כיצד ליצור ולהגדיר GraphClient מופע עם טוקן גישה, ולאחר מכן תרחישי שימוש טיפוסיים.

אימות Microsoft Graph עם MSAL.NET

כדי לעבוד עם Microsoft Graph באמצעות Aspose.Email ל‑.NET, עליך תחילה לאמת את האפליקציה שלך. ניתן לבצע זאת על‑ידי מימוש ה‑ ITokenProvider ממשק, המספק טוקני גישה ל‑ IGraphClient.

סעיף זה מנחה אותך דרך הגדרת MSAL.NET לקבלת טוקנים ואתחול ה‑ IGraphClient לשליחת בקשות מאומתות לשירותי Microsoft Graph.

ספריית האימות של מיקרוסופט (MSAL)

צעד 1: הגדרת מחלקת AccessParameters

צור מחלקה פשוטה לאחסון אישורי Microsoft 365 והקונפיגורציה הרלוונטית.

public class AccessParameters
{
    public string TenantId { get; init; }
    public string ClientId { get; init; }
    public string ClientSecret { get; init; }
    public string UserId { get; init; }
    public Uri Authority => new ($"https://login.microsoftonline.com/{TenantId}");
    public string ApiUrl => "https://graph.microsoft.com/.default";
}

צעד 2: התקנת חבילה MSAL.NET

הוסף את ה- Microsoft.Identity.Client חבילת NuGet לפרויקט שלך. היא כוללת את Microsoft Authentication Library (MSAL) המשמשת להשגת טוקני גישה.

dotnet add package Microsoft.Identity.Client

צעד 3: מימוד הממשק ITokenProvider

צור GraphTokenProvider מחלקה שמיישמת את ITokenProvider ממשק. מחלקה זו תשתמש בספריית MSAL.NET כדי לקבל אסימון גישה.

using Microsoft.Identity.Client;
using Microsoft.Identity.Web;
using Aspose.Email.Clients;

public class GraphTokenProvider : ITokenProvider
{
    private readonly IConfidentialClientApplication _app;
    private readonly string[] _scopes;
    private string? _token;

    public GraphTokenProvider(AccessParameters accessParams)
    {
        _app = ConfidentialClientApplicationBuilder.Create(accessParams.ClientId)
            .WithClientSecret(accessParams.ClientSecret)
            .WithAuthority(accessParams.Authority)
            .Build();

        _app.AddInMemoryTokenCache();

        _scopes = new[] { accessParams.ApiUrl };
    }

    public void Dispose()
    {
        throw new NotImplementedException();
    }

    public OAuthToken GetAccessToken()
    {
        return GetAccessToken(false);
    }

    public OAuthToken GetAccessToken(bool ignoreExistingToken)
    {
        if (!ignoreExistingToken && _token != null)
        {
            return new OAuthToken(_token);
        }

        _token = GetAccessTokenAsync().GetAwaiter().GetResult();
        return new OAuthToken(_token);
    }

    private async Task<string?> GetAccessTokenAsync()
    {
        AuthenticationResult? result;

        try
        {
            result = await _app.AcquireTokenForClient(_scopes)
                .ExecuteAsync();

            Console.WriteLine("Token acquired");
        }
        catch (MsalServiceException ex) when (ex.Message.Contains("AADSTS70011"))
        {
            Console.WriteLine("Scope provided is not supported");
            result = null;
        }

        if (result == null) return null;
        _token = result.AccessToken;
        return result.AccessToken;
    }

צעד 4: יצירת מופע ITokenProvider

לאחר ה‑ GraphTokenProvider המחלקה מוכנה, ניתן ליצור מופע שלה באמצעות אישורי האפליקציה שלך.

var accessParams = new AccessParameters()
{
    TenantId = "Your Tenant ID",
    ClientId = "Your Client ID",
    ClientSecret = "Your Client Secret",
    UserId = "User's Object ID"
};

var tokenProvider = new GraphTokenProvider(accessParams);

צעד 5: אתחול ה-IGraphClient

השתמש בספק הטוקן ליצירת IGraphClient מופע. הגדר את סוג המשאב וה‑ID כדי להתחיל לתקשר עם Microsoft Graph.

using var client = GraphClient.GetClient(tokenProvider, accessParams.TenantId);

client.Resource = ResourceType.Users;
client.ResourceId = accessParams.UserId;

ה-IGraphClient שלך מאומת כעת ומוכן לשלוח בקשות ל-Microsoft Graph בשם האפליקציה שלך.

התחברות לנקודת הקצה GCC High ב-Microsoft Graph

Aspose.Email GraphClient תומך בחיבור לנקודת הקצה Microsoft Graph GCC High על ידי הגדרת ה‑ EndPoint מאפיין ידנית. הגדר את המאפיין ל‑ https://graph.microsoft.us לפני ביצוע בקשות.

דוגמת הקוד הבאה מדגימה כיצד להגדיר את GraphClient להתחבר לנקודת הקצה GCC High לצורך רשימת תיקיות וקבלת הודעות.

client.EndPoint = "https://graph.microsoft.us";

var folders = client.ListFolders();
string folderId = folders.Find(x => x.DisplayName == "Inbox").ItemId;
var msgs = client.ListMessages(folderId);

אימות אסינכרוני ל-Microsoft Graph

השתמש ב- Aspose.Email.Clients.Graph.IGraphClientAsync ממשק לביצוע פעולות אסינכרוניות עם GraphClient. ה GraphClient.GetClientAsync(ITokenProvider, string) ו GraphClient.GetClientAsync(IMultipleServicesTokenProvider, string) שיטות מאפשרות לך לאתחל לקוחות Graph אסינכרוניים. דוגמת הקוד הבאה מדגימה כיצד להגדיר לקוח Microsoft Graph מאומת עם אישורי אפליקציית Azure AD כך שהוא יכול לפעול על תיבת הדואר של משתמש ספציפי:

var accessParameters = Settings.User1;

var provider = new AzureConfidentialTokenProvider(
    accessParameters.TenantId,
    accessParameters.ClientId,
    accessParameters.ClientSecret);

var client = GraphClient.GetClientAsync(provider, accessParameters.TenantId);

client.Resource = Aspose.Email.Clients.Graph.ResourceType.Users;
client.ResourceId = accessParameters.Username;
client.EndPoint = "https://graph.microsoft.com";

Net: גישה וניהול נתונים ב-Microsoft 365 עם Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

שפר את גישה וניהול הנתונים של Microsoft 365 באמצעות Aspose.Email Graph Client

Microsoft Graph זו API של REST לגישה לנתוני Microsoft 365. המימוש של Graph Client ב‑Aspose.Email עבור .NET מאפשר גישה ל‑Microsoft Graph מה‑API שלנו. בדוגמאות למטה ניצור מופע של MS Graph Client, נספק את האסימון. לאחר מכן נבחן את השיטות המרכזיות לניהול תיקיות, עדכון, העתקה ומחיקה שלהן. ניתן גם לגשת להודעות, לתוכן שלהן ולקבצים המצורפים או לשנות אותם עם ה‑MS Graph Client שלנו. ניהול קטגוריות, חוקים, מחברות ושינויים הוא תכונה מורחבת של Microsoft Graph Client מבוסס Aspose.Email.

אימות ובקשה עם IGraphClient באמצעות MSAL ב-.NET

כדי לתקשר עם שירותי Microsoft Graph, יהיה עליך ליצור IGraphClient אובייקט. לאחר האימות, לקוח זה מאפשר לבצע בקשות שירות שונות. ה- GetClient מתודה, שיוצרת את IGraphClient, דורש ITokenProvider מימוש כפרמטר הראשון שלו. זה ITokenProvider אחראית על מתן אסימון האימות הדרוש. כדי לקבל את האסימון, נשתמש ב- ספריית האימות של מיקרוסופט (MSAL) ל־.NET.

כך ניתן להגדיר את תהליך האימות:

שלב 1: הגדרת האימות

הצעדים הבאים ידריכו אותך כיצד לקבל אסימון הרשאה:

צור את מחלקת AccessParameters.

הגדר מחלקת AccessParameters לאחסון הפרטים שלך.

public class AccessParameters
{
    public string TenantId { get; init; }
    public string ClientId { get; init; }
    public string ClientSecret { get; init; }
    public string UserId { get; init; }
    public Uri Authority => new ($"https://login.microsoftonline.com/{TenantId}");
    public string ApiUrl => "https://graph.microsoft.com/.default";
}

הוסף את חבילת MSAL.NET.

התקן את Microsoft.Identity.Client חבילת NuGet, שמכילה את הבינאריים של MSAL.NET הדרושים לאימות.
מממש את ממשק ITokenProvider.

צור GraphTokenProvider מחלקה שמיישמת את ITokenProvider ממשק. מחלקה זו תשתמש בספריית MSAL.NET כדי לקבל אסימון גישה.

using Microsoft.Identity.Client;
using Microsoft.Identity.Web;
using Aspose.Email.Clients;

public class GraphTokenProvider : ITokenProvider
{
    private readonly IConfidentialClientApplication _app;
    private readonly string[] _scopes;
    private string? _token;

    public GraphTokenProvider(AccessParameters accessParams)
    {
        _app = ConfidentialClientApplicationBuilder.Create(accessParams.ClientId)
            .WithClientSecret(accessParams.ClientSecret)
            .WithAuthority(accessParams.Authority)
            .Build();

        _app.AddInMemoryTokenCache();

        _scopes = new[] { accessParams.ApiUrl };
    }

    public void Dispose()
    {
        throw new NotImplementedException();
    }

    public OAuthToken GetAccessToken()
    {
        return GetAccessToken(false);
    }

    public OAuthToken GetAccessToken(bool ignoreExistingToken)
    {
        if (!ignoreExistingToken && _token != null)
        {
            return new OAuthToken(_token);
        }

        _token = GetAccessTokenAsync().GetAwaiter().GetResult();
        return new OAuthToken(_token);
    }

    private async Task<string?> GetAccessTokenAsync()
    {
        AuthenticationResult? result;

        try
        {
            result = await _app.AcquireTokenForClient(_scopes)
                .ExecuteAsync();

            Console.WriteLine("Token acquired");
        }
        catch (MsalServiceException ex) when (ex.Message.Contains("AADSTS70011"))
        {
            Console.WriteLine("Scope provided is not supported");
            result = null;
        }

        if (result == null) return null;
        _token = result.AccessToken;
        return result.AccessToken;
    }

שלב 2: צור מופע של ITokenProvider

לאחר שהגדרת את ה- GraphTokenProvider class, אתה יכול ליצור מופע של AccessParameters ו השתמש בו כדי ליצור מופע של GraphTokenProvider.

var accessParams = new AccessParameters()
{
    TenantId = "Your Tenant ID",
    ClientId = "Your Client ID",
    ClientSecret = "Your Client Secret",
    UserId = "User's Object ID"
};

var tokenProvider = new GraphTokenProvider(accessParams);

שלב 3: בצע בקשות עם IGraphClient

לבסוף, השתמש ב- GraphTokenProvider כדי ליצור אובייקט מאומת IGraphClient והתחל לבצע בקשות שירות.

using var client = GraphClient.GetClient(tokenProvider, accessParams.TenantId);

client.Resource = ResourceType.Users;
client.ResourceId = accessParams.UserId;

לאחר השלמת הצעדים האלו, ה- IGraphClient מוכן כעת לתקשר עם שירותי Microsoft Graph באמצעות בקשות מאומתות.

התחברות לנקודות קצה של GCC High

ה GraphClient תומך בחיבור לנקודות קצה של GCC High באמצעות ה- EndPoint מאפיין. דוגמא הקוד הבאה מראה כיצד להגדיר את GraphClient להתחבר לנקודת הקצה של GCC High לצורך רשימת תיקיות וקבלת הודעות.

client.EndPoint = "https://graph.microsoft.us";

var folders = client.ListFolders();
string folderId = folders.Find(x => x.DisplayName == "Inbox").ItemId;
var msgs = client.ListMessages(folderId);

נהל תיקיות עם IGraphClient

רשימת תיקיות

על ידי קריאה ל- ListFolders מתודה מ-MS Graph Client, ניתן לקבל את רשימת התיקיות. לכל תיקייה יש קבוצת פרמטרים כגון DisplayName, שניתן לקרוא ב- FolderInfo סוג.

var folders = client.ListFolders();

foreach (var folder in folders)
{
    Console.WriteLine(folder.DisplayName);
}

עדכן תיקיות

כדי ליצור תיקייה עם MS Graph Client, השתמש ב- CreateFolder מתודה. תקבל FolderInfo אובייקט והאפשרות לגשת ל-DisplayName, ItemId, HasSubFolders ושאר המאפיינים.

var folderInfo = client.CreateFolder("FolderName");
folderInfo.DisplayName = "FolderAnotherName";
client.UpdateFolder(folderInfo);

העתק תיקיות

CopyFolder מתודה היא המתודה המרכזית להעתקת אובייקט התיקייה עם MS Graph.

var folderInfo1 = client.CreateFolder("Folder1");
var folderInfo2 = client.CreateFolder("Folder2");
    
// copy Folder2 to Folder1
client.CopyFolder(folderInfo1.ItemId, folderInfo2.ItemId);

הזז ומחק תיקיות

השתמש MoveFolder מתודה משמשת להעברת התיקייה, היא מקבלת newParentId ו-itemId. מחיקה מתודה משמשת למחיקת מתודה לפי מזהה.

var folderInfo1 = client.CreateFolder("Folder1");
var folderInfo2 = client.CreateFolder("Folder2");
    
// move Folder2 to Folder1
client.MoveFolder(folderInfo1.ItemId, folderInfo2.ItemId);
    
// delete Folder1
client.Delete(folderInfo1.ItemId)

נהל הודעות עם IGraphClient

MS Graph Client, המיושם ב-Aspose.Email עבור .NET, מספק קבוצה של מתודות לניהול הודעות וקבצים מצורפים:

רשימה הודעות
Fetch הודעה
Create הודעה
שלח הודעה
CopyMessage הודעה
העבר הודעה
CreateAttachment
FetchAttachment
DeleteAttachment
ListAttachments

רשימת הודעות

var folders = client.ListFolders();

foreach (var folder in folders)
{
    if (folder.DisplayName.Equals("Inbox"))
    {
        // list messages in inbox
        var inboxMessages = client.ListMessages(folder.ItemId);

        foreach (var messageInfo in inboxMessages)
        {
            Console.WriteLine(messageInfo.Subject);
        }
    }
}

סנן הודעות לפי תאריך שליחה

ה OrderBy מתודה מהאוסף של הספרייה מאפשרת לך לאחזר הודעות עם סידור שונים (עולה ויורד) על פי תאריך השליחה. דוגמא הקוד הבאה מציגה כיצד למיין הודעות לפי תאריך השליחה שלהן:

IGraphClient client = GraphClient.GetClient(provider, TenantId);

var builder = new GraphQueryBuilder();

// create orderby messages query 'DESC'
builder.SentDate.OrderBy(false);
var messagePageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(10), builder.GetQuery());
var messages = messagePageInfo.Items;

builder.Clear();

// create orderby messages query 'ASC'
builder.SentDate.OrderBy(true);
messagePageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(10), builder.GetQuery());
messages = messagePageInfo.Items;

רשימת הודעות עם תמיכת דפדוף

ה-API מאפשר דפדוף וסינון של ההודעות בעת הצגתן. זה מועיל במיוחד לתיבות דואר עם נפח גבוה של הודעות, שכן הוא חוסך זמן על ידי אחזור רק של המידע הסיכומי הדרוש.

דוגמא הקוד והצעדים למטה מראים כיצד לאחזר הודעות מתיקיית ה-Inbox באמצעות תכונות דפדוף וסינון.

קודם, אתחל את הלקוח.
לאחר מכן, קבע את מספר הפריטים להצגה לכל דף, לדוגמה, 10.
צור פילטר כדי לקבל רק הודעות שלא נקראו באמצעות ה- GraphQueryBuilder class. הביטוי builder.IsRead.Equals(false) מגדיר את התנאי לסינון הודעות שלא נקראו.
הפעל את ListMessages מתודה באובייקט הלקוח, מציינת את התיקייה (Inbox) ואת מספר הפריטים לכל דף (PageInfo(itemsPerPage)) כפרמטרים. היא גם מעבירה את אובייקט השאילתה כדי להחיל פילטר של הודעות שלא נקראו. אובייקט PageInfo שהוחזר (pageInfo) מכיל את ההודעות שהתקבלו לדף הנוכחי במאפיין Items.
צור לולאה שממשיכה עד שהדף האחרון מושג (pageInfo.LastPage הוא שקר). ההודעות שהתקבלו מתווספות לרשימת ההודעות הקיימת באמצעות messages.AddRange(pageInfo.Items).

//  reading unread messages with paging
using var client = GraphClient.GetClient(tokenProvider, config.Tenant);

// paging option
var itemsPerPage = 10;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.IsRead.Equals(false);
var query = builder.GetQuery();

// list messages
var pageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(itemsPerPage), query);
var  messages = pageInfo.Items;

while (!pageInfo.LastPage)
{
    pageInfo = client.ListMessages(KnownFolders.Inbox, pageInfo.NextPage, query);
    messages.AddRange(pageInfo.Items);
}

// set messages state as read
foreach (var message in messages)
{
    client.SetRead(message.ItemId);
}

קבל הודעות

var folders = client.ListFolders();

foreach (var folder in folders)
{
    if (folder.DisplayName.Equals("Inbox"))
    {
        // list messages in inbox
        var inboxMessages = client.ListMessages(folder.ItemId);

        if (inboxMessages.Count > 0)
        {
            // fetch the first message in inbox
            var msg = client.FetchMessage(inboxMessages[0].ItemId);
            
            Console.WriteLine(msg.BodyHtml);
        }
        
    }
}

צור הודעות

var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);

// create message in inbox
client.CreateMessage(KnownFolders.Inbox, msg);

שלח הודעות

// prepare the message
var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);
msg.SetProperty(KnownPropertyList.SenderName, "John");
msg.SetProperty(KnownPropertyList.SentRepresentingEmailAddress, "John@from.com");

// send message
client.Send(msg);

שלח הודעות טיוטה

// prepare the message
var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);
msg.SetProperty(KnownPropertyList.SenderName, "John");
msg.SetProperty(KnownPropertyList.SentRepresentingEmailAddress, "John@from.com");

// add message to Draft folder
var draftMessage = client.CreateMessage(KnownFolders.Drafts, msg);

// send a draft message
client.Send(draftMessage.ItemId);

שלח הודעות EML

יצירת והעברת דוא"ל היא פשוטה באמצעות האובייקט MailMessage. דוגמא קוד הבאה מציגה כיצד ליצור ולשלוח הודעת אימייל באמצעות Graph API:

// prepare the message
var eml = new MailMessage
{
    From = "from@domain.com",
    To = "to1@domain.com, to2@domain.com",
    Subject = "New message",
    HtmlBody = "<html><body>This is the HTML body</body></html>"
};

// send the message
graphClient.Send(eml);
graphClient.Create(KnownFolders.Inbox, eml);

העתק הודעות


// copy message to Inbox folder
var copiedMsg = client.CopyMessage(KnownFolders.Inbox, msg.ItemId);

העבר הודעות

// move message to Inbox folder
var movedMsg = client.MoveMessage(KnownFolders.Inbox, msg.ItemId);

ניהול קבצים מצורפים


// create an attachment
var attachment = new MapiAttachment();
attachment.SetProperty(KnownPropertyList.DisplayName, "My Attachment");
attachment.SetProperty(KnownPropertyList.AttachDataBinary, new byte[1024]);

// add an attachment to message
var createdAttachment = client.CreateAttachment(messageInfo.ItemId, attachment);

// fetch a message attachment
var fetchedAttachment = client.FetchAttachment(createdAttachment.ItemId);

// delete a message attachment 
client.DeleteAttachment(createdAttachment.ItemId);

// list the message attachments
var attachments = client.ListAttachments(messageInfo.ItemId);

נהל פריטי Outlook עם Graph Client

נהל אירועי לוח שנה

Aspose.Email מספקת API לגישה, ניהול ותקשורת עם אירועי לוח שנה. למטרות אלו, היא מציעה את המתודות הבאות ב- IGraphClient ממשק:

ListCalendars() - מאחזר אוסף של מידע על לוחות שנה.
ListCalendarItems(string id) - מאחזר אוסף של פריטי לוח שנה הקשורים למזהה הלוח שנה שנבחר.
FetchCalendarItem(string id) - מאחזר פריט לוח שנה ספציפי בהתבסס על המזהה שניתן.
CreateCalendarItem(string calId, MapiCalendar mapiCalendar) - יוצר פריט לוח שנה חדש בלוח שנה שצוין.
UpdateCalendarItem(MapiCalendar mapiCalendar) - מעדכן פריט לוח שנה קיים.
UpdateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) - מעדכן פריט לוח שנה קיים עם הגדרות עדכון ספציפיות.

דוגמא קוד הבאה מציגה כיצד לתקשר עם אירועי לוח שנה ב- Microsoft Graph API client באמצעות המתודות שמספקת Aspose.Email:


// List Calendars
CalendarInfoCollection calendars = graphClient.ListCalendars();

// List Calendar Items
MapiCalendarCollection calendarItems = graphClient.ListCalendarItems("calendarId");

// Fetch Calendar Item
MapiCalendar calendarItem = graphClient.FetchCalendarItem("calendarItemId");

// Create Calendar Item
MapiCalendar newCalendarItem = new MapiCalendar(
    location: "Conference Room",
    summary: "Team Meeting",
    description: "Discuss project status and updates.",
    startDate: startDate,
    endDate: endDate
);

MapiCalendar createdCalendarItem = graphClient.CreateCalendarItem("calendarId", newCalendarItem);

// Update Calendar Item
createdCalendarItem.Location = "Zoom Meeting";
MapiCalendar updatedCalendarItem = graphClient.UpdateCalendarItem(createdCalendarItem);

נהל קטגוריות

כדי לנהל קטגוריות עם MS Graph באמצעות Aspose.Email עבור .NET, השתמש במתודות הבאות:

// create a custom category with Orange color
var category = client.CreateCategory("My custom category", CategoryPreset.Preset1);

// fetch a category
var fetchedCategory = client.FetchCategory(category.Id);

// update category (change color to brown)
fetchedCategory.Preset = CategoryPreset.Preset2;
var updatedCategory = client.UpdateCategory(fetchedCategory);

// list available categories
var categories = client.ListCategories();

foreach (var cat in categories)
{
    Console.WriteLine(cat.DisplayName);
}

// delete a category
client.Delete(fetchedCategory.Id);

נהל אנשי קשר

Aspose.Email מספקת API לגישה, ניהול ותקשורת עם פריטי קשר. למטרות אלו, היא מציעה את המתודות הבאות ב- IGraphClient ממשק:

ListContacts(string id) - מאחזר אוסף של אנשי קשר MAPI הקשורים למזהה התיקייה שנבחר.
FetchContact(string id) - מאחזר איש קשר ספציפי בהתבסס על מזהה הפריט שניתן.
CreateContact(string folderId, MapiContact contact) - יוצר איש קשר חדש בתיקייה שצוין.
UpdateContact(MapiContact contact) - מעדכן איש קשר קיים.

דוגמא קוד הבאה מציגה כיצד לתקשר עם אנשי קשר ב- Microsoft Graph API client באמצעות המתודות שמספקת Aspose.Email:

// List Contacts
MapiContactCollection contacts = graphClient.ListContacts("contactFolderId");

// Fetch Contact
MapiContact contact = graphClient.FetchContact("contactId");

// Create Contact
MapiContact newContact = new MapiContact("Jane Smith", "jane.smith@example.com", "XYZ Corporation", "777-888-999");

MapiContact createdContact = graphClient.CreateContact("contactFolderId", newContact);

// Update Contact
createdContact.Telephones.PrimaryTelephoneNumber = "888-888-999";

MapiContact updatedContact = graphClient.UpdateContact(createdContact);

נהל דריסות

כדי לנהל דריסות (overrides) עם MS Graph באמצעות Aspose.Email עבור .NET, השתמש במתודות הבאות:

// Create an user's override
var userOverride = client.CreateOrUpdateOverride
    (new MailAddress("JohnBrown@someorg.com", "JohnBrown"), ClassificationType.Focused);

// list the overrides
var overrides = client.ListOverrides();

// update override
userOverride.Sender.DisplayName = "John Brown";
var updatedOverride = client.UpdateOverride(userOverride);

// delete override
client.Delete(updatedOverride.Id);

נהל כללים

כדי לנהל כללים עם MS Graph באמצעות Aspose.Email עבור .NET, השתמש במתודות הבאות:

// Create a rule
var rule = PrepareRule("user@someorg.com", "User");
var createdRule = client.CreateRule(rule);

// List all rules defined for Inbox
var rules = client.ListRules();

// Fetch a rule
var fetchedRule = client.FetchRule(createdRule.RuleId);

// Update a rule
fetchedRule.DisplayName = "Renamed rule";
fetchedRule.IsEnabled = false;
var updatedRule = client.UpdateRule(createdRule);

// Delete a rule
client.Delete(updatedRule.RuleId);

InboxRule PrepareRule(string email, string displayName)
{
    var rule = new InboxRule()
    {
        DisplayName = "My rule",
        Priority = 1,
        IsEnabled = true,
        Conditions = new RulePredicates(),
        Actions = new RuleActions()
    };

    rule.Conditions.ContainsSenderStrings = new StringCollection { displayName };
    rule.Actions.ForwardToRecipients = new MailAddressCollection
        { new MailAddress(email, displayName, true) };
    rule.Actions.StopProcessingRules = true;

    return rule;
}

נהל מחברות

כדי לנהל מחברות עם MS Graph באמצעות Aspose.Email עבור .NET, השתמש במתודות הבאות:

// create a OneNote notebook
var newNotebook = new Notebook()
{
    DisplayName = "My Notebook"
};
var createdNotebook = client.CreateNotebook(newNotebook);

// fetch a notebook
var fetchedNotebook = client.FetchNotebook(createdNotebook.Id);

// list the notebooks
var notebooks = client.ListNotebooks();

ניהול משימות ב-Microsoft Graph

Aspose.Email מספקת למפתחים API לגישה, ניהול ואינטראקציה עם משימות ורשימות משימות של משתמשים באמצעות המתודות הבאות של ה‑ IGraphClient ממשק:

ListTaskLists() - מחזיר אוסף של מידע על רשימות משימות.
GetTaskList(string id) - מחזיר רשימת משימות ספציפית בהתבסס על המזהה שסופק.
DeleteTaskList(string id) - מוחק את רשימת המשימות שהוגדרה. -ListTasks(string id) - מאחזר אוסף של משימות המשויכות למזהה רשימת המשימות שצויין.
FetchTask(string id) - מאחזר משימה ספציפית בהתבסס על המזהה שסופק.
CreateTask(MapiTask task, string taskListUri) - יוצר משימה חדשה ברשימת המשימות שצוינה.
UpdateTask(MapiTask task) - מעדכן משימה קיימת עם המידע שסופק.
UpdateTask(MapiTask task, UpdateSettings updateSettings) - מעדכן משימה קיימת עם הגדרות עדכון מוגדרות.

דוגמאות הקוד הבאות מציגות כיצד לנהל רשימות משימות:

// List Task Lists
var taskLists = graphClient.ListTaskLists();

foreach (var tList in taskLists)
{
    Console.WriteLine($"Task List: {tList.DisplayName}");
}

// Get Task List
var taskList = graphClient.GetTaskList("taskListId");

// Delete Task List
graphClient.DeleteTaskList("taskListId");

דוגמאות הקוד הבאות מציגות כיצד לנהל משימות:

// List Tasks in a Task List
MapiTaskCollection tasks = graphClient.ListTasks("taskListId");

// Fetch Task
MapiTask task = graphClient.FetchTask("taskId");

// Create Task
var newTask = new MapiTask
{
    Subject = "New Task",
    DueDate = new DateTime(2023, 12, 31),
    Status = MapiTaskStatus.NotStarted
};

MapiTask createdTask = graphClient.CreateTask(newTask, "taskListUri");

// Update Task
createdTask.Subject = "Updated Task Subject";
MapiTask updatedTask = graphClient.UpdateTask(createdTask);

// Update Task with UpdateSettings
var updateSettings = new UpdateSettings { SkipAttachments  = true };
MapiTask updatedTaskWithSettings = graphClient.UpdateTask(createdTask, updateSettings);

Net: ניהול תיקיות דואר ב‑Microsoft Graph (Aspose.Email)

Mon, 01 Jan 0001 00:00:00 +0000

ה‑Aspose.Email IGraphClient הממשק מספק מתודות ליצירה, רישום, עדכון, העתקה, העברה ומחיקה של תיקיות באמצעות Microsoft Graph.

רשימת תיקיות

השתמש ב- ListFolders מתודה לאחזור כל התיקיות הזמינות למשתמש הנוכחי. כל תיקייה מוחזרת כ‑ FolderInfo אובייקט הכולל מאפיינים כגון DisplayName, ItemId, HasSubFolders ועוד.

var folders = client.ListFolders();

foreach (var folder in folders)
{
    Console.WriteLine(folder.DisplayName);
}

רשימת תיקיות באופן אסינכרוני

הדוגמה הבאה מציגה כיצד לאחזר את כל התיקיות בתיבת דואר ולהציג את שמותיהן באמצעות ה‑ ListFoldersAsync שיטה.

var folders = await client.ListFoldersAsync();
foreach (var folder in folders)
{
    Console.WriteLine(folder.DisplayName);
}

var folderId = folders.Find(x => x.DisplayName == "Inbox").ItemId;
var msgsPage = await client.ListMessagesAsync(folderId, new PageInfo(15) { PageOffset = 0 }, null);
var msgs = msgsPage.Items;
foreach (var msg in msgs)
{
    Console.WriteLine(msg.Subject);
}

יצירה ועדכון של תיקייה

כדי ליצור תיקייה חדשה, קרא ל‑ CreateFolder מתודה. היא מחזירה FolderInfo אובייקט, שניתן לשנות ולעדכן באמצעות ה‑ UpdateFolder() שיטה.

var folderInfo = client.CreateFolder("FolderName");
folderInfo.DisplayName = "FolderAnotherName";
client.UpdateFolder(folderInfo);

העתקת תיקייה

השתמש ב- CopyFolder מתודה להעתקת תיקייה למיקום אב חדש. מתודה זו דורשת את מזהה תיקיית האב היעד ואת המזהה של התיקייה המועתקת.

var folderInfo1 = client.CreateFolder("Folder1");
var folderInfo2 = client.CreateFolder("Folder2");
    
// copy Folder2 to Folder1
client.CopyFolder(folderInfo1.ItemId, folderInfo2.ItemId);

העברה ומחיקה של תיקייה

כדי להעביר תיקייה, השתמש ב‑ MoveFolder מתודה המקבלת newParentId ו‑itemId.
כדי למחוק תיקייה, השתמש ב‑ מחיקה מתודה וספק את ה‑ItemId של התיקייה.

var folderInfo1 = client.CreateFolder("Folder1");
var folderInfo2 = client.CreateFolder("Folder2");
    
// move Folder2 to Folder1
client.MoveFolder(folderInfo1.ItemId, folderInfo2.ItemId);
    
// delete Folder1
client.Delete(folderInfo1.ItemId)

Net: נהל הודעות אי‑מייל וקבצים מצורפים באמצעות Microsoft Graph

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email IGraphClient מספק מגוון רחב של שיטות לניהול הודעות דוא"ל וקבצים מצורפים באמצעות Microsoft Graph.

פעולות זמינות:

רשימת הודעות
סינון וגלישה בין הודעות
קבלת תוכן הודעה
יצירה ושליחת הודעות (כולל טיוטות ו-EML)
העתקה והעברת הודעות
ניהול קבצים מצורפים (יצירה, אחזור, מחיקה, רשימה)

רשימה הודעות
Fetch הודעה
Create הודעה
שלח הודעה
CopyMessage הודעה
העבר הודעה
CreateAttachment
FetchAttachment
DeleteAttachment
ListAttachments

רשימת הודעות

כדי לשחזר הודעות מתיקייה כגון "Inbox", השתמש ב- ListMessages שיטה.

שחזור רשימת התיקיות באמצעות client.ListFolders().
עבור על כל תיקייה.
בדוק אם שם התצוגה של התיקייה הוא "Inbox".
אם כן, רשום את ההודעות בתיבת הדואר הנכנס באמצעות client.ListMessages(folder.ItemId).
עבור על כל הודעה בתיבת הדואר הנכנס.
הדפס את נושא כל הודעה לקונסול.

var folders = client.ListFolders();

foreach (var folder in folders)
{
    if (folder.DisplayName.Equals("Inbox"))
    {
        // list messages in inbox
        var inboxMessages = client.ListMessages(folder.ItemId);

        foreach (var messageInfo in inboxMessages)
        {
            Console.WriteLine(messageInfo.Subject);
        }
    }
}

רשימת הודעות באופן אסינכרוני עם Microsoft Graph

דוגמת הקוד שלהלן מציגה כיצד לגשת לתיקיית ה‑Inbox, לשחזר דף של הודעות אימייל עם ListMessagesAsync, והדפס את הנושאים שלהם:

var folders = await client.ListFoldersAsync();
foreach (var folder in folders)
{
    Console.WriteLine(folder.DisplayName);
}

var folderId = folders.Find(x => x.DisplayName == "Inbox").ItemId;
var msgsPage = await client.ListMessagesAsync(folderId, new PageInfo(15) { PageOffset = 0 }, null);
var msgs = msgsPage.Items;
foreach (var msg in msgs)
{
    Console.WriteLine(msg.Subject);
}

סנן הודעות לפי תאריך שליחה

אתחל את Graph Client
- צור מופע של IGraphClient באמצעות GraphClient.GetClient() עם הספק ו‑TenantId.
בנה בונה שאילתות
- צור מופע של GraphQueryBuilder אובייקט.
מיין הודעות לפי תאריך ב‑:

סדר יורד
- השתמש builder.SentDate.OrderBy(false) כדי להגדיר את הסדר בירידה.
- קרא client.ListMessages() כדי לקבל הודעות מתיבת הדואר הנכנס עם מגבלה של 10, באמצעות השאילה מ‑ builder.GetQuery().
- אחסן את ההודעות שהתקבלו במשתנה messages.
סדר עולה
- הגדר את הסדר לעולה על‑ידי קריאה ל‑ builder.SentDate.OrderBy(true).
- השתמש client.ListMessages() שוב כדי לשחזר הודעות מתיבת הדואר הנכנס, כעת בסדר עולה.
- אחסן הודעות אלו במשתנה messages.

IGraphClient client = GraphClient.GetClient(provider, TenantId);

var builder = new GraphQueryBuilder();

// create orderby messages query 'DESC'
builder.SentDate.OrderBy(false);
var messagePageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(10), builder.GetQuery());
var messages = messagePageInfo.Items;

builder.Clear();

// create orderby messages query 'ASC'
builder.SentDate.OrderBy(true);
messagePageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(10), builder.GetQuery());
messages = messagePageInfo.Items;

רשימת הודעות עם דפדוף וסינון

השתמש בדפדוף בעת עבודה עם תיבות דואר גדולות. הדוגמה שלהלן משחזרת הודעות שלא נקראו בעמודים של 10 ומסמנת אותן כנקראו לאחר עיבוד:

אתחל את ה‑client.
הגדר את מספר הפריטים להצגה בכל עמוד, לדוגמה, 10.
צור פילטר כדי לקבל רק הודעות שלא נקראו באמצעות ה- GraphQueryBuilder מחלקה. ה- builder.IsRead.Equals(false) מגדיר את התנאי לסינון הודעות שלא נקראו.
הפעל את ListMessages מתודה באובייקט הלקוח, מציינת את התיקייה (Inbox) ואת מספר הפריטים לכל דף (PageInfo(itemsPerPage)) כפרמטרים. היא גם מעבירה את אובייקט השאילתה כדי להחיל פילטר של הודעות שלא נקראו. אובייקט PageInfo שהוחזר (pageInfo) מכיל את ההודעות שהתקבלו לדף הנוכחי במאפיין Items.
צור לולאה שממשיכה עד להגעה לעמוד האחרון (pageInfo.LastPage הוא false). ההודעות שהתקבלו מתווספות לרשימת ההודעות הקיימת באמצעות messages.AddRange(pageInfo.Items).

//  reading unread messages with paging
using var client = GraphClient.GetClient(tokenProvider, config.Tenant);

// paging option
var itemsPerPage = 10;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.IsRead.Equals(false);
var query = builder.GetQuery();

// list messages
var pageInfo = client.ListMessages(KnownFolders.Inbox, new PageInfo(itemsPerPage), query);
var  messages = pageInfo.Items;

while (!pageInfo.LastPage)
{
    pageInfo = client.ListMessages(KnownFolders.Inbox, pageInfo.NextPage, query);
    messages.AddRange(pageInfo.Items);
}

// set messages state as read
foreach (var message in messages)
{
    client.SetRead(message.ItemId);
}

שחזר הודעה

שחזר את התוכן המלא של הודעה ספציפית. דוגמת הקוד שלהלן מציגה כיצד לשחזר ולהציג את ההודעה האחרונה בתיבת הדואר הנכנס לתצוגה או לעיבוד:

קרא client.ListFolders() כדי לשחזר את כל התיקיות הקיימות בתיבת הדואר ולאחסן אותן במשתנה folders.
עבור על כל תיקייה באוסף התיקיות בעזרת לולאת foreach.
בתוך הלולאה, בדוק אם שם התצוגה של התיקייה הוא "Inbox".
אם התיקייה היא תיבת הדואר הנכנס, שלוף את ההודעות באמצעות client.ListMessages() עם ה‑ItemId של התיקייה.
בדוק אם קיימות הודעות בתיבת הדואר הנכנס על‑ידי אימות ש‑inboxMessages.Count גדול מ‑0.
אם קיימות הודעות, שלוף את ההודעה הראשונה באמצעות client.FetchMessage() עם ה‑ItemId של ההודעה הראשונה.
פלט את גוף ה‑HTML של ההודעה שהועברה.

var folders = client.ListFolders();

foreach (var folder in folders)
{
    if (folder.DisplayName.Equals("Inbox"))
    {
        // list messages in inbox
        var inboxMessages = client.ListMessages(folder.ItemId);

        if (inboxMessages.Count > 0)
        {
            // fetch the first message in inbox
            var msg = client.FetchMessage(inboxMessages[0].ItemId);
            
            Console.WriteLine(msg.BodyHtml);
        }
        
    }
}

שאילתות Microsoft Graph עם OData

Aspose.Email עבור .NET מספקת תמיכה בשאילתות OData עבור Microsoft Graph. זה מאפשר למפתחים ליישם סינון מתקדם, מיון, בחירה, דפדוף והרחבה בעת עבודה עם משאבי Graph כגון תיקיות, הודעות, אנשי קשר, פריטי לוח שנה ועוד. ה-Aspose.Email.Clients.Graph.ODataQueryBuilder מחלקה נבנית כדי לבנות פרמטרים של שאילתות OData בצורה מובנית במקום לבנות מחרוזות שאילתה ידנית. כך ניתן לשאוב רק את השדות הדרושים (Select) ליעילות, השתמש בסינון (Filter) ומיון (OrderBy) לארגון נתונים. ניתן גם ליישם דפדוף (Top, Skip) עבור מערכי נתונים גדולים, הרחב ישויות קשורות (Expand) בקריאה אחת, ולהפעיל ספירה וחיפוש טקסט מלא לתרחישים מתקדמים.

להלן רשימת GraphClient מתודות התומכות ב-ODataQueryBuilder פרמטר:**

ListFolders
ListMessages
ListContacts
ListCalendarItems
ListAttachments
ListCategories
ListOverrides
ListRules
ListTaskLists
ListTasks
ListNotebooks

דוגמת הקוד שלהלן מציגה כיצד להשתמש ב-ODataQueryBuilder כדי לרשום תיקיות ולשלוף הודעות אימייל מסוננות, ממוינות ומפוצלות מדף בתיבת דואר:**

var accessParameters = Settings.User1;

var provider = new AzureConfidentialTokenProvider(
    accessParameters.TenantId,
    accessParameters.ClientId,
    accessParameters.ClientSecret);

var client = GraphClient.GetClient(provider, accessParameters.TenantId);

client.Resource = Aspose.Email.Clients.Graph.ResourceType.Users;
client.ResourceId = accessParameters.Username;
client.EndPoint = "https://graph.microsoft.com";

// Example 1: List folders ordered by name
var builder = new ODataQueryBuilder { OrderBy = "name asc" };
var folders = client.ListFolders(builder);

foreach (var folder in folders)
{
    Console.WriteLine(folder.DisplayName);
}

// Example 2: Retrieve filtered and paged messages from Inbox
var folderId = folders.Find(x => x.DisplayName == "Inbox").ItemId;

builder = new ODataQueryBuilder
{
    Filter = "startswith(name,'A')",
    OrderBy = "name asc",
    Top = 10,
    Skip = 5,
    Select = new[] { "name", "age" },
    Expand = new[] { "children", "parents" },
    Count = true,
    Search = "\"John Doe\"",
    Format = "json"
};

var msgs = client.ListMessages(folderId, builder);

foreach (var msg in msgs)
{
    Console.WriteLine(msg.Subject);
}

יצירת הודעה

השתמש ב- CreateMessage מתודה לשמירת הודעה חדשה ישירות לתיקייה ספציפית, כגון תיבת הדואר הנכנס. הדוגמה שלהלן מציגה כיצד לבנות MapiMessage ולכלול אותה בתיבת הדואר.

var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);

// create message in inbox
client.CreateMessage(KnownFolders.Inbox, msg);

שלח הודעות

ה שלח מתודה של IGraphClient מאפשר לך לשלוח הודעת אימייל ישירות באמצעות MapiMessage אובייקט. בדוגמה זו נוצר הודעה פשוטה, מוגדרת עם פרטי השולח והנמען, ואז נשלחת.

// prepare the message
var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);
msg.SetProperty(KnownPropertyList.SenderName, "John");
msg.SetProperty(KnownPropertyList.SentRepresentingEmailAddress, "John@from.com");

// send message
client.Send(msg);

שלח הודעת טיוטה

ניתן לשמור הודעה לתיקיית הטיוטות ולשלוח אותה מאוחר יותר באמצעות IGraphClient. גישה זו מאפשרת להכין הודעה, לבדוק או לשנות אותה לפני שליחה, ולאחר מכן לשלוח אותה כאשר היא מוכנה. דוגמת הקוד שלהלן מציגה כיצד ליצור אימייל, להוסיף מטא‑נתונים, לאחסן אותו כטיוטה, ואז לשלוח אותו:

צור MapiMessage עם נושא, גוף ונמענים.
הגדר פרטי השולח באמצעות מאפייני ההודעה.
שמור את ההודעה לתיקיית הטיוטות באמצעות CreateMessage.
שלח את הטיוטה על‑ידי העברת ItemId שלה ל- Send() שיטה.

// prepare the message
var msg = new MapiMessage(OutlookMessageFormat.Unicode)
{
    Subject = "My message",
    Body = "Hi, it is my message"
};

msg.Recipients.Add("sam@to.com", "Sam", MapiRecipientType.MAPI_TO);
msg.SetProperty(KnownPropertyList.SenderName, "John");
msg.SetProperty(KnownPropertyList.SentRepresentingEmailAddress, "John@from.com");

// add message to Draft folder
var draftMessage = client.CreateMessage(KnownFolders.Drafts, msg);

// send a draft message
client.Send(draftMessage.ItemId);

שלח הודעה בפורמט EML

השתמש ב- MailMessage מחלקה ליצירה ושליחה של הודעות בפורמט EML. דוגמת הקוד שלהלן מציגה כיצד ליצור ולשלוח הודעת אימייל באמצעות Graph API:

// prepare the message
var eml = new MailMessage
{
    From = "from@domain.com",
    To = "to1@domain.com, to2@domain.com",
    Subject = "New message",
    HtmlBody = "<html><body>This is the HTML body</body></html>"
};

// send the message
graphClient.Send(eml);
graphClient.Create(KnownFolders.Inbox, eml);

העתק הודעות

כדי ליצור העתק של הודעת אימייל קיימת, השתמש ב- CopyMessage שיטה של IGraphClient ממשק.


// copy message to Inbox folder
var copiedMsg = client.CopyMessage(KnownFolders.Inbox, msg.ItemId);

העבר הודעות

כדי להעביר הודעת אימייל קיימת מהמיקום הנוכחי לתיקייה חדשה, השתמש ב- MoveMessage שיטה של IGraphClient ממשק.

// move message to Inbox folder
var movedMsg = client.MoveMessage(KnownFolders.Inbox, msg.ItemId);

ניהול קבצים מצורפים

ה IGraphClient ב‑Aspose.Email עבור .NET מאפשר לעבוד עם קבצים מצורפים לאימייל בתכנות. זה כולל יצירה, שליפה, מחיקה והצגת רשימת הקבצים המצורפים להודעה. דוגמת הקוד שלהלן מציגה ניהול מלא של מחזור חיי הקובץ המצורף עבור הודעות Outlook דרך Microsoft Graph API באמצעות Aspose.Email. ניתן להתאים את תוכן הקובץ המצורף והמטא‑נתונים לפי הצורך.


// create an attachment
var attachment = new MapiAttachment();
attachment.SetProperty(KnownPropertyList.DisplayName, "My Attachment");
attachment.SetProperty(KnownPropertyList.AttachDataBinary, new byte[1024]);

// add an attachment to message
var createdAttachment = client.CreateAttachment(messageInfo.ItemId, attachment);

// fetch a message attachment
var fetchedAttachment = client.FetchAttachment(createdAttachment.ItemId);

// delete a message attachment 
client.DeleteAttachment(createdAttachment.ItemId);

// list the message attachments
var attachments = client.ListAttachments(messageInfo.ItemId);

Net: ניהול פריטי Outlook דרך Aspose.Email Graph Client

Mon, 01 Jan 0001 00:00:00 +0000

נהל אירועי לוח שנה

Aspose.Email מספקת API לגישה, ניהול ותקשורת עם אירועי לוח שנה. למטרות אלו, היא מציעה את המתודות הבאות ב- IGraphClient ממשק:

ListCalendars() - מאחזר אוסף של מידע על לוחות שנה.
ListCalendarItems(string id) - מאחזר אוסף של פריטי לוח שנה הקשורים למזהה הלוח שנה שנבחר.
FetchCalendarItem(string id) - מאחזר פריט לוח שנה ספציפי בהתבסס על המזהה שניתן.
CreateCalendarItem(string calId, MapiCalendar mapiCalendar) - יוצר פריט לוח שנה חדש בלוח שנה שצוין.
UpdateCalendarItem(MapiCalendar mapiCalendar) - מעדכן פריט לוח שנה קיים.
UpdateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) - מעדכן פריט לוח שנה קיים עם הגדרות עדכון ספציפיות.

דוגמא קוד הבאה מציגה כיצד לתקשר עם אירועי לוח שנה ב- Microsoft Graph API client באמצעות המתודות שמספקת Aspose.Email:


// List Calendars
CalendarInfoCollection calendars = graphClient.ListCalendars();

// List Calendar Items
MapiCalendarCollection calendarItems = graphClient.ListCalendarItems("calendarId");

// Fetch Calendar Item
MapiCalendar calendarItem = graphClient.FetchCalendarItem("calendarItemId");

// Create Calendar Item
MapiCalendar newCalendarItem = new MapiCalendar(
    location: "Conference Room",
    summary: "Team Meeting",
    description: "Discuss project status and updates.",
    startDate: startDate,
    endDate: endDate
);

MapiCalendar createdCalendarItem = graphClient.CreateCalendarItem("calendarId", newCalendarItem);

// Update Calendar Item
createdCalendarItem.Location = "Zoom Meeting";
MapiCalendar updatedCalendarItem = graphClient.UpdateCalendarItem(createdCalendarItem);

נהל קטגוריות הודעות

כדי לנהל קטגוריות עם MS Graph באמצעות Aspose.Email עבור .NET, השתמש במתודות הבאות ונסה את קטע הקוד למטה:

// create a custom category with Orange color
var category = client.CreateCategory("My custom category", CategoryPreset.Preset1);

// fetch a category
var fetchedCategory = client.FetchCategory(category.Id);

// update category (change color to brown)
fetchedCategory.Preset = CategoryPreset.Preset2;
var updatedCategory = client.UpdateCategory(fetchedCategory);

// list available categories
var categories = client.ListCategories();

foreach (var cat in categories)
{
    Console.WriteLine(cat.DisplayName);
}

// delete a category
client.Delete(fetchedCategory.Id);

נהל אנשי קשר

Aspose.Email מספקת API לגישה, ניהול ותקשורת עם פריטי קשר. למטרות אלו, היא מציעה את המתודות הבאות ב- IGraphClient ממשק:

ListContacts(string id) - מאחזר אוסף של אנשי קשר MAPI הקשורים למזהה התיקייה שנבחר.
FetchContact(string id) - מאחזר איש קשר ספציפי בהתבסס על מזהה הפריט שניתן.
CreateContact(string folderId, MapiContact contact) - יוצר איש קשר חדש בתיקייה שצוין.
UpdateContact(MapiContact contact) - מעדכן איש קשר קיים.

דוגמא קוד הבאה מציגה כיצד לתקשר עם אנשי קשר ב- Microsoft Graph API client באמצעות המתודות שמספקת Aspose.Email:

// List Contacts
MapiContactCollection contacts = graphClient.ListContacts("contactFolderId");

// Fetch Contact
MapiContact contact = graphClient.FetchContact("contactId");

// Create Contact
MapiContact newContact = new MapiContact("Jane Smith", "jane.smith@example.com", "XYZ Corporation", "777-888-999");

MapiContact createdContact = graphClient.CreateContact("contactFolderId", newContact);

// Update Contact
createdContact.Telephones.PrimaryTelephoneNumber = "888-888-999";

MapiContact updatedContact = graphClient.UpdateContact(createdContact);

נהל דריסות

כדי לנהל דריסות (overrides) עם MS Graph באמצעות Aspose.Email עבור .NET, השתמש במתודות הבאות:

// Create an user's override
var userOverride = client.CreateOrUpdateOverride
    (new MailAddress("JohnBrown@someorg.com", "JohnBrown"), ClassificationType.Focused);

// list the overrides
var overrides = client.ListOverrides();

// update override
userOverride.Sender.DisplayName = "John Brown";
var updatedOverride = client.UpdateOverride(userOverride);

// delete override
client.Delete(updatedOverride.Id);

נהל כללי תיבת דואר נכנס

כדי לנהל כללים עם MS Graph באמצעות Aspose.Email עבור .NET, השתמש במתודות הבאות:

// Create a rule
var rule = PrepareRule("user@someorg.com", "User");
var createdRule = client.CreateRule(rule);

// List all rules defined for Inbox
var rules = client.ListRules();

// Fetch a rule
var fetchedRule = client.FetchRule(createdRule.RuleId);

// Update a rule
fetchedRule.DisplayName = "Renamed rule";
fetchedRule.IsEnabled = false;
var updatedRule = client.UpdateRule(createdRule);

// Delete a rule
client.Delete(updatedRule.RuleId);

InboxRule PrepareRule(string email, string displayName)
{
    var rule = new InboxRule()
    {
        DisplayName = "My rule",
        Priority = 1,
        IsEnabled = true,
        Conditions = new RulePredicates(),
        Actions = new RuleActions()
    };

    rule.Conditions.ContainsSenderStrings = new StringCollection { displayName };
    rule.Actions.ForwardToRecipients = new MailAddressCollection
        { new MailAddress(email, displayName, true) };
    rule.Actions.StopProcessingRules = true;

    return rule;
}

נהל מחברות OneNote

כדי לנהל מחברות עם MS Graph באמצעות Aspose.Email עבור .NET, השתמש במתודות הבאות:

// create a OneNote notebook
var newNotebook = new Notebook()
{
    DisplayName = "My Notebook"
};
var createdNotebook = client.CreateNotebook(newNotebook);

// fetch a notebook
var fetchedNotebook = client.FetchNotebook(createdNotebook.Id);

// list the notebooks
var notebooks = client.ListNotebooks();

ניהול משימות ב‑Microsoft Graph

ListTaskLists() - מחזיר אוסף של מידע על רשימות משימות.
GetTaskList(string id) - מחזיר רשימת משימות ספציפית בהתבסס על המזהה שסופק.
DeleteTaskList(string id) - מוחק את רשימת המשימות שהוגדרה. -ListTasks(string id) - מאחזר אוסף של משימות המשויכות למזהה רשימת המשימות שצויין.
FetchTask(string id) - מאחזר משימה ספציפית בהתבסס על המזהה שסופק.
CreateTask(MapiTask task, string taskListUri) - יוצר משימה חדשה ברשימת המשימות שצוינה.
UpdateTask(MapiTask task) - מעדכן משימה קיימת עם המידע שסופק.
UpdateTask(MapiTask task, UpdateSettings updateSettings) - מעדכן משימה קיימת עם הגדרות עדכון מוגדרות.

דוגמאות הקוד הבאות מציגות כיצד לנהל רשימות משימות:

// List Task Lists
var taskLists = graphClient.ListTaskLists();

foreach (var tList in taskLists)
{
    Console.WriteLine($"Task List: {tList.DisplayName}");
}

// Get Task List
var taskList = graphClient.GetTaskList("taskListId");

// Delete Task List
graphClient.DeleteTaskList("taskListId");

דוגמאות הקוד הבאות מציגות כיצד לנהל משימות:

// List Tasks in a Task List
MapiTaskCollection tasks = graphClient.ListTasks("taskListId");

// Fetch Task
MapiTask task = graphClient.FetchTask("taskId");

// Create Task
var newTask = new MapiTask
{
    Subject = "New Task",
    DueDate = new DateTime(2023, 12, 31),
    Status = MapiTaskStatus.NotStarted
};

MapiTask createdTask = graphClient.CreateTask(newTask, "taskListUri");

// Update Task
createdTask.Subject = "Updated Task Subject";
MapiTask updatedTask = graphClient.UpdateTask(createdTask);

// Update Task with UpdateSettings
var updateSettings = new UpdateSettings { SkipAttachments  = true };
MapiTask updatedTaskWithSettings = graphClient.UpdateTask(createdTask, updateSettings);