Időzónák és visszhangok cserébe
Ismerje meg, hogyan működnek az időzónák a kezelt EWS API és az Exchange Web Services Exchange szolgáltatásban.
Az időzónák nem olyanok, amikért a legtöbb felhasználó sokkal többet tud meghatározni. Ezek azonban fontos fogalmak, amikor meghatározzák a dátumot és az időt a felügyelt Exchange Web Services API vagy Exchange Web Services használatával. A kezelt EWS API vagy az Exchange Web Services alkalmazás hibás időzónái kiszámíthatatlan következményekhez vezethetnek. Az időzónák helyes kezelése, könnyen, ameddig tudod, hogyan.
Ha a felügyelt Exchange Web Services API-t használja, az időzónák a legtöbb esetben automatikusan kezelik Önt. Kifejezett felhasználói művelet nélkül az API az ügyfélszámítógép helyi időzónáját és az összes szükséges konverziót használja a háttérben. Ez nagyon hasznos a megfelelő hatással, de van más lehetősége is.
Az egyik lehetőség az ExchangeService.TimeZone tulajdonságának feladata. Ez a tulajdonság határozza meg a Manageed Exchange Web Services API-val végrehajtott lekérdezések időzónáját. Ez a tulajdonság csak olvasható; Az egyetlen módja a konfigurálásnak az osztálykonstruktornak köszönhető. Ha ExchangeService (System.TimeZoneInfo) vagy az ExchangeService tervezőt (ExchangeVersion, System.TimeZoneInfo) használ. egy meghatározott időzónát megadhat a System.TimeZoneInfo objektumnak. Ha a többi konstrukciót használja, a TimeZoneInfo objektum nem szerepel paraméterként. az ExchangeService osztály a TimeZone tulajdonságot állítja be az ügyfélszámítógép aktuális időzónájára.
A TimeZone tulajdonság által képviselt időzóna azt fejezi ki, hogy a feladat egy adott időzónában van-e, vagy az ügyfélszámítógép időzónájának, az összes dátumnak és időpontnak. A Managed Exchange Web Services API az összes dátum- és idő tulajdonságot System.DateTime-struktúrává teszi. Ezért, ha a dátum és az idő minden tulajdonságát állítja be, akkor nem biztos, hogy az a dátum, amikor a megadott feldolgozást a DateTime.Kind tulajdonság értéke a DateTime objektumon alapul. Ha a Kind ingatlan nem specifikált. A DateTime értéke úgy értelmezhető, mint a TimeZone tulajdonság által meghatározott időzónában. Ha elolvassa a dátumot és az időt, akkor az összes DateTime tulajdonság ebben az időzónában jelenik meg.
1. táblázat: Az időzónák tulajdonságai a felügyelt Exchange Web Services API-ban
Ha Exchange Web Services szolgáltatást használ, az időzónák nem kezelnek automatikusan az Ön számára, és a körülmények valamivel bonyolultabbak. Az Exchange Web Service időzónák hatása a kérésekre és a válaszokra több tényezőtől függ:
A RequestServerVersion elemben megadott Exchange verzió
A TimeZoneContext elemben megadott időzónát (ha van)
A MeetingTimeZone-ban megadott időzóna. StartTimeZone. vagy EndTimeZone elemek (amennyiben vannak találkozókon vagy találkozókon)
A dateTime XML elemekben megadott időzóna (ha van ilyen)
Ha az időzóna a dateTime (UTC vagy meghatározott időzóna) értékében van jelen, akkor ezt az értéket mindig ez az időzónának értelmezi. Ha nincs időzónája, az Értelmező érték az adott időzónához társított egyéb elemek meghatározott csoportjától függ.
2. Táblázat Az Exchange Web Services elemeinek időzónája és hatása
Az értékben megadott időzónában
Ha a StartTimeZone elem jelen van, a Start és ReminderDueBy elemek értéke a StartTimeZone elem időzóna. Ellenkező esetben az elemek értéke az időzónában értelmezhető a TimeZoneContext elemben.
Ha az EndTimeZone elem jelen van, a Start elem értéke az EndTimeZone elem időzónaként értelmezhető. Ellenkező esetben a végelem értékét a TimeZoneContext elem időzónaként értelmezi.
A CalendarItem vagy a MeetingRequest kívül található elemeket az TimeZoneContext elem időzónaként értelmezik.
Időzóna a StartTimeZone elemben. ha ezt a paramétert megadja, a TimeZoneContext elem időzónája. ha nem így van
Az értékben megadott időzónában
Mint a TimeZoneContext időzónája
Időzóna a TimeZoneContextben
Az értékben megadott időzónában
Ha a StartTimeZone elem jelen van, a Start és ReminderDueBy elemek értéke a StartTimeZone elem időzóna. Ellenkező esetben az elemek értéke UTC-ként értelmezhető.
Ha az EndTimeZone elem jelen van, a Start elem értéke az EndTimeZone elem időzónaként értelmezhető. Ellenkező esetben a végelem értékét UTC-ként értelmezik.
A CalendarItem vagy a MeetingRequest kívül található elemek UTC-ként értelmezendőek.
Időzóna a StartTimeZone elemben. ha ezt a paramétert megadta, UTC, ha nem így van
Az értékben megadott időzónában
A válaszok értelmezése a szerverről mindig ellenőrizze az egyes elemek értékét, és ennek megfelelően értelmezze az értéket. Az értékcsere mindig tartalmazza az időzónát (UTC vagy meghatározott időzónát).
Találkozó vagy megbeszélés létrehozásakor a kezdési időpontra vonatkozó időzóna úgy tekintendő, mint egy időzóna létrehozása az értekezlethez. Az értekezlet vagy a találkozó létrehozásának dátumának / időpontjának értelmezésén túl a létrehozási időzónának az alábbi hatásai vannak:
Ha a találkozó tétele, a létrehozási időzónát megjeleníti az résztvevők által beérkező találkozókérések Outlook információs paneljében, ha ez az időzóna eltér az ügyfelek időzónájától.