对于任何追随我的人-这是有关其工作原理的详细信息。我还将使用源文件发布对我的博客的引用。
简而言之 - 约会使用 UID 属性绑定在一起。此属性也称为 CleanUniqueIdentifier。虽然此示例代码可以根据下面博客文章中引用的“错误”修复进行调整,但此源代码已完成,因为要求适用于 => 2007 SP1。
这假设您事先了解 EWS 是什么以及如何使用它 ( EWS API )。这也是基于博文“ EWS:同一会议的孤立实例的 UID 并不总是相同”和“使用 Exchange Web Services 2007 搜索具有特定 UID 的会议”的博文
需要的设置才能工作:
- 可以是“代表”或对各个帐户具有“模拟”权限的用户帐户。
问题:交换中的每个“约会”都有一个唯一的 id (Appointment.Id),它是确切的实例标识符。有了这个 id,如何在日历中找到所有相关实例(重复或与会者请求)?
下面的代码概述了如何实现这一点。
[TestFixture]
public class BookAndFindRelatedAppoitnmentTest
{
public const string ExchangeWebServiceUrl = "https://contoso.com/ews/Exchange.asmx";
[Test]
public void TestThatAppointmentsAreRelated()
{
ExchangeService service = GetExchangeService();
//Impersonate the user who is creating the Appointment request
service.ImpersonatedUserId = new ImpersonatedUserId( ConnectingIdType.PrincipalName, "Test1" );
Appointment apptRequest = CreateAppointmentRequest( service, new Attendee( "Test2@contoso.com" ) );
//After the appointment is created, we must rebind the data for the appointment in order to set the Unique Id
apptRequest = Appointment.Bind( service, apptRequest.Id );
//Impersonate the Attendee and locate the appointment on their calendar
service.ImpersonatedUserId = new ImpersonatedUserId( ConnectingIdType.PrincipalName, "Test2" );
//Sleep for a second to let the meeting request propogate YMMV so you may need to increase the sleep for this test
System.Threading.Thread.Sleep( 1000 );
Appointment relatedAppt = FindRelatedAppointment( service, apptRequest );
Assert.AreNotEqual( apptRequest.Id, relatedAppt.Id );
Assert.AreEqual( apptRequest.ICalUid, relatedAppt.ICalUid );
}
private static Appointment CreateAppointmentRequest( ExchangeService service, params Attendee[] attendees )
{
// Create the appointment.
Appointment appointment = new Appointment( service )
{
// Set properties on the appointment.
Subject = "Test Appointment",
Body = "Testing Exchange Services and Appointment relationships.",
Start = DateTime.Now,
End = DateTime.Now.AddHours( 1 ),
Location = "Your moms house",
};
//Add the attendess
Array.ForEach( attendees, a => appointment.RequiredAttendees.Add( a ) );
// Save the appointment and send out invites
appointment.Save( SendInvitationsMode.SendToAllAndSaveCopy );
return appointment;
}
/// <summary>
/// Finds the related Appointment.
/// </summary>
/// <param name="service">The service.</param>
/// <param name="apptRequest">The appt request.</param>
/// <returns></returns>
private static Appointment FindRelatedAppointment( ExchangeService service, Appointment apptRequest )
{
var filter = new SearchFilter.IsEqualTo
{
PropertyDefinition = new ExtendedPropertyDefinition
( DefaultExtendedPropertySet.Meeting, 0x03, MapiPropertyType.Binary ),
Value = GetObjectIdStringFromUid( apptRequest.ICalUid ) //Hex value converted to byte and base64 encoded
};
var view = new ItemView( 1 ) { PropertySet = new PropertySet( BasePropertySet.FirstClassProperties ) };
return service.FindItems( WellKnownFolderName.Calendar, filter, view ).Items[ 0 ] as Appointment;
}
/// <summary>
/// Gets the exchange service.
/// </summary>
/// <returns></returns>
private static ExchangeService GetExchangeService()
{
//You can use AutoDiscovery also but in my scenario, I have it turned off
return new ExchangeService( ExchangeVersion.Exchange2007_SP1 )
{
Credentials = new System.Net.NetworkCredential( "dan.test", "Password1" ),
Url = new Uri( ExchangeWebServiceUrl )
};
}
/// <summary>
/// Gets the object id string from uid.
/// <remarks>The UID is formatted as a hex-string and the GlobalObjectId is displayed as a Base64 string.</remarks>
/// </summary>
/// <param name="id">The uid.</param>
/// <returns></returns>
private static string GetObjectIdStringFromUid( string id )
{
var buffer = new byte[ id.Length / 2 ];
for ( int i = 0; i < id.Length / 2; i++ )
{
var hexValue = byte.Parse( id.Substring( i * 2, 2 ), System.Globalization.NumberStyles.AllowHexSpecifier );
buffer[ i ] = hexValue;
}
return Convert.ToBase64String( buffer );
}
}