Обзор мобильной объектной модели SharePoint
Сведения о новых открытых классах в серверной объектной модели SharePoint и клиентской объектной модели Silverlight, которые используются для разработки интегрированных решений для SharePoint и Windows Phone 7.5.
Клиентская объектная модель для мобильных устройств Silverlight
Все классы в этом разделе содержатся в пространстве имен Microsoft.SharePoint.Client. В дополнение к API в этом разделе большая часть классов и членов в разделе Server объектной модели для мобильной работы SharePoint также можно вызвать в клиентской объектной модели. Для классов, которые начинаются с «Пакет обновления», имя клиента объектной модели имеет «Пакет обновления» удален. В других случаях указано имя клиента объектной модели. Имена элементов применяются в клиентской объектной модели, за исключением там, где указано иное.
Важно!
Настройки на основе JSLink (клиентская обработка) не поддерживаются в современном интерфейсе. Это относится к современным спискам и библиотекам, включая поддержку JSLink в веб-частях представления списка современных страниц. Клиентская обработка поддерживается в классических интерфейсах в SharePoint Online или локальной версии.
Класс AlternateUrl
Представляет альтернативный URL-адрес для веб-приложения и зоны, к которой применяется.
public class AlternateUrl
Свойства
Uri (только для чтения)
Возвращает URI альтернативный URL-адрес.
public String Uri
UrlZone (только для чтения)
Получает зона альтернативного URL-адреса.
public UrlZone UrlZone
Класс UrlZone является версия объектной модели клиента класса SPUrlZone в серверной объектной модели. Дополнительные сведения об этом см. в пакете SDK для SharePoint 2010.
Класс AuthenticationCompletedEventArgs
Предоставляет данные о событии AuthenticationCompleted.
public sealed class AuthenticationCompletedEventArgs : AsyncCompletedEventArgs
Конструкторы
Инициализирует новый экземпляр класса AuthenticationCompletedEventArgs.
public AuthenticationCompletedEventArgs(Exception error, bool canceled, HttpStatusCode userState)
Параметры
error это объект исключения, в случае отсутствия исключение при попытке проверки подлинности.
canceled имеет значение true, если попытки проверки подлинности отменена, прежде чем оно может быть выполнен удачно или нет.
userState это HttpStatusCode, возвращенные сервером.
Свойства
HttpStatusCode (только для чтения)
Получает состояние, возвращенные сервером после при попытке проверки подлинности.
public HttpStatusCode HttpStatusCode
Перечисление AuthenticationStatus
Указывает текущее состояние при попытке проверки подлинности.
NotStarted
InProgress
CompletedSuccess
CompletedException
Класс проверки подлинности
Предоставляет методы для проверки подлинности пользователя на веб-сайте SharePoint.
public class Authenticator : ICredentials
Конструкторы
Инициализирует новый экземпляр класса.
public Authenticator()
public Authenticator(Uri uagServerUrl)
Параметры
uagServerUrl это полный URL-адрес сервера United Access Gateway (UAG).
public Authenticator(string userName, string password)
Параметры
userName это имя для учетных данных.
password пароль для учетных данных.
public Authenticator(string userName, string password, string domain)
Параметры
userName это имя для учетных данных.
password пароль для учетных данных.
domain это имя домена или компьютера, где проверяются учетные данные, обычно домена текущего пользователя.
public Authenticator(string userName, string password, Uri uagServerUrl)
Параметры
userName это имя для учетных данных.
password пароль для учетных данных.
uagServerUrl это полный URL-адрес сервера United Access Gateway (UAG).
public Authenticator(string userName, string password, string domain, Uri uagServerUrl)
Параметры
userName это имя для учетных данных.
password пароль для учетных данных.
domain это имя домена или компьютера, где проверяются учетные данные, обычно домена текущего пользователя.
uagServerUrl это полный URL-адрес сервера United Access Gateway (UAG).
Методы
ClearAllApplicationSettings
Очищает все файлы cookie, учетные данные и параметры UAG из кэша.
public static void ClearAllApplicationSettings
ClearAllCookies
Очищает все хранимые файлы cookie и присваивает свойству Status все объекты Authenticator значение NotStarted.
public static void ClearAllCookies()
ClearAllCredentials
Очищает все учетные данные из кэша и устанавливает для свойства Status всех объектов Authenticator значение NotStarted.
public static void ClearAllCredentials()
GetCredential
Возвращает объект учетных данных для указанного типа uri и режим проверки подлинности.
public NetworkCredential GetCredential(Uri uri, string authType)
Параметры
uri это URI, включая порт, для которого клиент предоставляет проверку подлинности.
authType тип проверки подлинности, требуемой.
Этот метод используется только для анонимной проверки подлинности. Если authType не является "Базовым", возвращается пустой объект. Дополнительные сведения о классе NetworkCredential можно Класс NetworkCredential.
IsRequestUnauthorized
Возвращает значение true, если не удалось выполнить запрос авторизации из-за недопустимый файл cookie или учетные данные.
public static bool IsRequestUnauthorized(ClientRequestFailedEventArgs failedEventArgs)
Свойства
AllowSmartRouting
Получает или задает указывает, включена ли смарт-маршрутизации.
public bool AllowSmartRouting
При включении смарт-Маршрутизация объект Authenticator пытается подключиться к серверу под управлением SharePoint и сервер UAG и использует, какое из значений отвечает первым, как его канал связи. Если нет ни одного сервера UAG, это свойство игнорируется. Значение по умолчанию true. Если параметр имеет значение false, сервер UAG всегда используется.
AuthenticatorMode
Получает или задает режим проверки подлинности.
public ClientAuthenticationMode AuthenticationMode
Дополнительные сведения о ClientAuthenticationMode enum содержатся в этом документе.
CookieCachingEnabled
Получает или задает указывает, является ли кэшируются файлы cookie.
public bool CookieCachingEnabled
Если включить кэширование файлов cookie, необходимо учитывайте, что файлы cookie к определенному моменту истечения срока действия. Если они истек срок действия при вызове ExecuteQueryAsync, затем происходит сбой и выполняется обратного вызова для сбоев. Соответственно Если этому свойству присвоено значение true, необходимо добавить код для обратного вызова для ошибки, очищает кэш в этом случае. Ниже приведен пример, где execQueryArgs имеет тип ClientRequestFailedEventArgs, переданного сбоя обратного вызова ExecuteQueryAsync.
if (Authenticator.IsRequestUnauthorized(execQueryArgs))
{
(sender as Authenticator).ClearCookies();
}
CredentialCachingEnabled
Получает или задает индикатор ли кэширование учетных данных.
public bool CredentialCachingEnabled
Domain
Получает или задает домен или компьютер для учетных данных, обычно это домен текущего пользователя.
public string Domain
Если новое значение для этого свойства, свойство Status имеет значение NotStarted.
NavigateBackAfterAuthentication
Получает или задает индикатор ли пользователь которому выполняется переход на предыдущую страницу со страницы входа в систему.
public bool NavigateBackAfterAuthentication
Password
Получает или задает пароль для учетных данных.
public string Password
Если новое значение для этого свойства, свойство Status имеет значение NotStarted.
PromptOnFailure
Получает или задает указывает, следует ли пользователь запрос на введите имя и пароль, если происходит сбой первоначальной проверки подлинности.
public bool PromptOnFailure
Status (только для чтения)
Получает состояние попытки проверки подлинности.
public AuthenticationStatus Status
Просмотрите ранее в этом документе для получения сведений о классе AuthenticationStatus.
UagServerUrl
Получает или задает URL-адрес сервера UAG.
public Uri UagServerUrl
UserName
Получает или задает имя пользователя для учетных данных.
public string UserName
Если новое значение для этого свойства, свойство Status имеет значение NotStarted.
События
AuthenticationCompleted
Возникает после завершения попытки проверки подлинности, независимо от того, является ли выполнено успешно.
public event EventHandler<AuthenticationCompletedEventArgs> AuthenticationCompleted;
Перечисление ClientAuthenticationMode
Задает режим проверки подлинности для объекта Authenticator. Это существующего enum, к которому новое значение BrowserBasedAuthentication был добавлен.
| Тип | Описание |
|---|---|
| FormsAuthentication | Представляет режим проверки подлинности на основе форм |
| Anonymous | Представляет режим анонимного доступа |
| BrowserBasedAuthentication | Представляет режим Microsoft Office Forms на основе проверки подлинности (MSOFBA) |
Класс ODataAuthenticator
Предоставляет методы для проверки подлинности пользователя на веб-сайте SharePoint.
public class ODataAuthenticator : Authenticator
Конструкторы
Конструкторы, совпадают конструкторы класса parent. Для получения дополнительных сведений см проверки подлинности данного документа.
Методы
Authenticate
Выполняет проверку подлинности пользователя для указанного веб-сайта.
public new void Authenticate(Uri serverUrl)
Ключевое new слово используется, так как родительский класс имеет внутренний метод с тем же именем.
Свойства
CookieContainer (только для чтения)
Получает контейнер с помощью файлов cookie для запросов к веб-сайту.
public new CookieContainer CookieContainer
Ключевое new слово используется, так как родительский класс имеет внутренний метод с тем же именем.
ResolvedUrl (только для чтения)
Получает URL-адрес, который используется для подключений к серверу, на котором работает SharePoint при использовании ODataAuthenticator. Это может быть опубликован на сервере UAG URL-адрес или, если свойство AllowSmartRouting имеет значение true, это может быть URL-адрес интрасети SharePoint, если он будет достигнуто первым при вызове метода Authenticate.
public Uri ResolvedUrl
Класс ServerSettings
Предоставляет метод для получения альтернативные URL-адреса веб-приложения, который содержит веб-сайта.
public static class ServerSettings
Методы
GetAlternateUrls
Получает альтернативные URL-адреса указанного веб-сайта.
public static ClientObjectList<AlternateUrl> GetAlternateUrls(ClientRuntimeContext context)
Параметры
context это объект, представляющий текущий контекст клиента.
Просмотрите ранее в этом документе для получения сведений о классе AlternateUrl.
Серверная объектная модель для мобильной работы SharePoint
Все классы в этом разделе содержатся в пространстве имен Microsoft.SharePoint. За исключением того, если он указан, все они доступны в клиентской объектной модели. Для классов, которые начинаются с «Пакет обновления», имя клиента объектной модели имеет «Пакет обновления» удален. В других случаях указано имя клиента объектной модели. Имена элементов применяются в клиентской объектной модели, за исключением там, где указано иное.
Класс GeolocationFieldControl
(Недоступно в клиентской объектной модели).
Управляет визуализации поля SPFieldGeolocation. Объект этого типа используется как значение свойства FieldRenderingControl объекта SPFieldGeolocation.
public class GeolocationFieldControl : BaseFieldControl
Связи со этот класс также Обратите внимание, что существует шаблоны отображения двух: для режима отображения и для создания и редактирования режима. Они определены в файле %SHAREPOINTROOT%\TEMPLATE\ControlTemplates\DefaultTemplates.ascx.
Fields
Факторы, используемые для отображения поля в режимах создания и редактирования.
protected TextBox m_latitudeBox;
protected TextBox m_longitudeBox;
protected Label m_longitudeLabel;
protected Label m_latitudeLabel;
Методы
Открытые свойства отсутствуют не полученных вводятся с помощью этого класса. Существует стандартного переопределения некоторых производные методов, как показано в следующей таблице.
| Метод | Это переопределение??? |
|---|---|
| CreateChildControls |
Создает дочерние элементы управления, включая элемент управления карты JavaScript для режима отображения. |
| центр конференций |
Переключает фокус дочернего элемента управления textbox долгота. |
| OnPreRender |
Вызывает метод базового. |
| Проверка |
Проверяет Широта и долгота значения, которые отображаются в пользовательском интерфейсе (UI). Не выполняет проверку свойства Longitude и Latitude базового объекта SPFieldGeolocatonValue, которое будет отличаться, если пользователь изменить одно или несколько из следующих значений в пользовательском Интерфейсе и не был сохранен изменения. |
Свойства
Открытые свойства отсутствуют не полученных вводятся с помощью этого класса. Существует стандартного переопределения некоторых производные свойств, как указано в следующей таблице.
| Свойство | Это переопределение... |
|---|---|
| CssClass |
Ведет себя так же, как реализация parent. |
| DefaultTemplateName |
Возвращает «GeolocationField» |
| DisplayTemplateName |
Возвращает «GeolocationDisplayField» |
| Значение |
Получает или задает значение, отображаемое с помощью объекта SPFieldGeolocationValue. |
Класс SPFieldGeolocation
Представляет поля (столбца), в котором размещается расположения в разных странах мира, определенные в долгота и широта и возможно высота.
public class SPFieldGeolocation : SPField
В связи с этим классом тип поля Географическое расположение определяется в % SHAREPOINTROOT%\TEMPLATE\XML\fldtypes.xml.
Конструкторы (перегрузка)
Инициализирует новый экземпляр класса SPFieldGeolocation.
public SPFieldGeolocation(SPFieldCollection fields, string fieldName)
public SPFieldGeolocation(SPFieldCollection fields, string fieldName, string displayName)
Параметры
fields представляет коллекцию типов полей, к которым будет добавлен новый объект типа поля.
fieldName это внутреннее имя нового типа поля.
displayName это понятное имя нового типа поля.
Методы
GetFieldValueForClientRender
Получает значение поля, чтобы он отображался на стороне клиента.
public override object GetFieldValueForClientRender(SPItem item, SPControlMode mode)
Параметры
item это текущего элемента списка.
mode является текущий режим отображения, такие как создание, изменение или отображение.
GetJsonClientFormFieldSchema
Получает поле схемы в виде Нотация объектов JavaScript (JSON).
public override Dictionary<string, object> GetJsonClientFormFieldSchema(SPControlMode mode)
Параметры
mode является текущий режим отображения, такие как создание, изменение или отображение.
ValidateAndParseValue
Проверяет, что указанный элемент списка не равно null, а затем проверяется, что строка структурированы в соответствии с стандарты Open Consortium геопространственных (OGC) и возвращает его в качестве объекта, который является возможностью приведения к типу SPFieldGeolocationValue.
public override object ValidateAndParseValue(SPListItem item, string value)
Параметры
item элемент списка, который должен быть обновлено значением.
Строка value представляет значение географического расположения.
Следующие методы, стандартного переопределения унаследованных методов, которые были в SharePoint 2010. Сведения, относящиеся к этот класс является в следующей таблице.
| Метод | Это переопределение... |
|---|---|
| GetFieldValue (String s) |
Возвращает указанное значение как объект, который является возможностью приведения SPFieldGeolocationValue. |
| GetFieldValueAsText (объект o) |
Перенос GetValidatedString. |
| GetValidatedString (объект o) |
Проверяет, что указанное значение структурированы в соответствии с стандарты Open Consortium геопространственных (OGC) и возвращает как строку. |
Свойства
JSLink
Получает или задает имя файла JavaScript, которая отображает поля типа SPFieldGeolocation.
Примечание.
Свойство JSLink не поддерживается в списках Survey или Events. Календарь SharePoint это список событий.
public override string JSLink
Значение по умолчанию "clienttemplates.js| Geolocationfieldtemplate.js|SP.map.js".
FieldRenderingMobileWebControl
Получает объект SPMobileGeolocationField, который отображает поле.
public override SPMobileBaseFieldControl FieldRenderingMobileControl
Это свойство заменяет устаревший FieldRenderingMobileControl.
Другие свойства это стандартные переопределений наследуемые свойства, которые были в SharePoint 2010. Сведения, относящиеся к этот класс является в следующей таблице.
| Свойство | Переопределение... |
|---|---|
| FieldValueType |
Возвращает typeof(SPFieldGeolocationValue). |
| FieldRenderingControl |
Возвращает объект GeolocationFieldControl. |
| Filterable |
Возвращает false. |
| Sortable |
Возвращает false. |
| Устарел. FieldRenderingMobileControl |
Возвращает объект SPMobileGeolocationField. |
Класс SPFieldGeolocationValue
Представляет папку на разных странах мира, определенные в долгота и широта и возможно высота слишком.
public class SPFieldGeolocationValue : SPFieldGeographyValue
Конструкторы (перегрузка)
Инициализирует новый экземпляр класса SPFieldGeolocationValue.
public SPFieldGeolocationValue()
public SPFieldGeolocationValue(string fieldValue)
public SPFieldGeolocationValue(double latitude, double longitude)
public SPFieldGeolocationValue(double latitude, double longitude, double altitude, double measure)
Параметры
fieldValue это строка в одном из следующих форматов хорошо известные текста (WKT):
"Точка (широта долготы)", где долгота и широта являются строками из одной или нескольких цифр, при необходимости включая одну точку (которая интерпретируется как десятичная точка) и при необходимости начинается с дефиса (который интерпретируется как отрицательный знак).
"Точка (мерашироты долготы)", где долгота, широта, высота имера являются строками из одной или нескольких цифр, при необходимости включая одну точку (которая интерпретируется как десятичная точка) и при необходимости начинается с дефиса (который интерпретируется как отрицательный знак).
latitude является Широта и должно быть между-90.0 и 90,0.
longitude является долгота и должно быть между-180.0 и 180.0.
altitude это высота.
measure это альтернативное обозначение точки. Свойству Measure далее в этом разделе, для получения дополнительных сведений см.
Методы
ToString
Это переопределение возвращает одно из следующих действий в зависимости от того, является ли Altitude или Measure свойств назначенных ненулевое значение.
Если ни высота, ни мер назначенных ненулевое значение:
"Точка (широта долготы)", где долгота и широта являются строками из одной или нескольких цифр, при необходимости включая одну точку (которая интерпретируется как десятичная точка) и при необходимости начинается с дефиса (который интерпретируется как отрицательный знак).
В противном случае (по крайней мере один из Altitude или Measure назначенных ненулевое значение):
"Точка (долгота измерения высоты широты)", где долгота, широта, высота имера представляют собой строки из одной или нескольких цифр, при необходимости включая одну точку (которая интерпретируется как десятичная точка) и при необходимости начинается с дефиса (который интерпретируется как отрицательный знак). Если Altitude или Measure не присвоен ненулевое значение, оно отображается как "0" в значение свойства WellKnownText. Обратное не хранит: Если Altitude или Measure отображается как 0, которая, возможно, поскольку он никогда не была назначена ненулевое значение, но может быть так, как она была назначена 0.
public override string ToString()
ToWellKnownText
Перенос ToString.
public string ToWellKnownText()
Свойства
Altitude
Получает или задает высота расположения. Использование этого свойства является необязательной и предполагаемой единицы измерения (например, метры) и нулевой точки (например, уровень sea или центр earth) определенного пользователя.
public double Altitude
Latitude
Получает или задает Широта расположения.
public double Latitude
Значение должно быть между-90.0 и 90,0.
Longitude
Получает или задает Долгота расположения.
public double Longitude
Значение должно быть между-180.0 и 180.0...
Measure
Получает или задает альтернативного обозначение точка расположении, определяемых пользователем. К примеру Если точку по магистраль с маркерами вех, это свойство может использоваться для хранения число вех, наиболее близко к точке. Если точка находится в общей области турпоходов с нумерованный campsites, это свойство может использоваться для хранения номера ближайшего campsite. Свойство семантика полностью определить пользователя и его использование не является обязательным.
public double Measure
Перечисление SPFieldType
Добавлен новое значение для данного перечисления:
Geolocation
Класс SPPhoneNotificationContent
Базовый класс для классов, которые представляют содержимое phone уведомлений. Производные классы необходимо объявить поля или свойства для хранения контента и необходимо реализовать метод PreparePayload для преобразования содержимого в массив байтов.
public abstract class SPPhoneNotificationContent
Методы
PreparePayload
При реализации в класс, производный преобразует содержимое в массив байтов, который отправляется по сети в службу уведомлений. Нет нет реализации по умолчанию, поэтому производный класс необходимо реализовать этот метод.
protected internal abstract byte[] PreparePayload();
Свойства
NotificationType (только для чтения)
Получает тип уведомления (например, плитки или всплывающего уведомления) предназначен контента.
public SPPhoneNotificationType NotificationType
Сведения о SPPhoneNotificationTypeсодержатся в этом документе.
SubscriberType (только для чтения)
Получает тип подписчика устройств, например, Windows Phone.
public SPPhoneNotificationSubscriberType SubscriberType
Сведения о SPPhoneNotificationSubscriberTypeсодержатся в этом документе.
Класс SPPhoneNotificationResponse
Отображает результат при попытке отправить уведомление.
public class SPPhoneNotificationResponse
Методы
Create
Создает объект SPPhoneNotificationResponse.
public static SPPhoneNotificationResponse
Create(SPPhoneNotificationSubscriberType subscriberType,
SPPhoneNotificationType notificationType, HttpWebResponse response)
Параметры
subscriberType это устройства, такие как Windows Phone 7.5.
notificationType тип уведомлений, такие как всплывающее или плитки.
response это объект HTTP-ответа, который был создан на сервере.
Дополнительные сведения о SPPhoneNotificationSubscriberType и SPPhoneNotificationTypeможно далее в этом документе.
Свойства
NotificationType (только для чтения)
Получает тип уведомления (например, всплывающее или заголовков).
public SPPhoneNotificationType NotificationType
Сведения о SPPhoneNotificationType содержатся в этом документе.
ServiceToken (только для чтения)
Получает маркер службы уведомлений, который использовался в уведомлении.
public string ServiceToken
StatusCode (только для чтения)
Получает код состояния HTTP. Строковая версия HttpStatusCode значение.
public string StatusCode
Тип подписчика
Получает или задает тип устройства, к которому было отправлено уведомление.
public SPPhoneNotificationSubscriberType SubscriberType
Сведения о SPPhoneNotificationSubscriberTypeсодержатся в этом документе.
TimeStamp (только для чтения)
Время UTC уведомления.
public DateTime Timestamp
Класс SPPhoneNotificationSubscriber
Базовый класс для классов, которые представляют подписчика уведомлений, выданный приложения SharePoint на стороне сервера.
public abstract class SPPhoneNotificationSubscriber
Методы
Уведомить
Отправляет содержимое указанного уведомлений подписчика с проверки ошибок.
public SPPhoneNotificationResponse Notify(SPPhoneNotificationContent notificationContent)
Параметры
notificationContent, сведения о событии, инициирующую уведомления.
Этот метод не может быть переопределен. Он является оболочкой для метода абстрактный NotifyInternal и гарантирует, что некоторые проверки ошибок выполняется при вызове NotifyInternal.
Дополнительные сведения о классах SPPhoneNotificationContent и SPPhoneNotificationResponse можно выше в этом документе.
NotifyInternal
При переопределении в производный класс, отправляет содержимое указанного уведомлений подписчика.
protected abstract SPPhoneNotificationResponse NotifyInternal(SPPhoneNotificationContent notificationContent);
Параметры
notificationContent, сведения о событии, инициирующую уведомления.
Дополнительные сведения о классах SPPhoneNotificationContent и SPPhoneNotificationResponse можно выше в этом документе.
ToString
Возвращает свойства выбранного объекта в виде строки.
public override string ToString()
Реализация по умолчанию включает в себя свойства ParentWeb, ApplicationTagи DeviceAppInstanceId.
Update
Сохраняет объект (возможно, измененных) SPPhoneNotificationSubscriber хранилища подписчика веб-сайта.
public void Update()
ValidateSubscriberProperties
При реализации в класс, производный проверяет выбранных свойств объекта.
protected abstract void ValidateSubscriberProperties();
Свойства
CustomArgs
Получает или задает строку пользовательские аргументы, который представляет состояние подписки на уведомления. Эта строка могут использоваться логики приложения для различения его подписчиков уведомлений для разных видов уведомлений.
public string CustomArgs
DeviceAppInstanceId (только для чтения)
Получает идентификатор для конкретного экземпляра приложения на телефоне или другого мобильного устройства.
public Guid DeviceAppInstanceId
LastModifiedTimeStamp (только для чтения)
Получает дату и время последнего изменения подписчика.
public DateTime LastModifiedTimeStamp
RegistrationTimeStamp (только для чтения)
Получает дату и время, когда абонентского зарегистрированных для уведомлений.
public DateTime RegistrationTimeStamp
ServiceToken
Получает или задает сведения о канала доставки, необходимая для службы уведомлений, такие как URI-канал.
public string ServiceToken
SubscriberType (только для чтения)
Получает тип устройства, такие как Windows Phone 7.
public SPPhoneNotificationSubscriberType SubscriberType
Сведения о классе SPPhoneNotificationSubscriberType содержатся далее в этом документе.
User (только для чтения)
Получает пользователя, который зарегистрирован для уведомлений.
public SPUser User
Класс SPPhoneNotificationSubscriberCollection
Коллекция подписчиков уведомлений. Индексаторы Int32 проходит объект коллекции.
public sealed class SPPhoneNotificationSubscriberCollection : SPBaseCollection
Свойства
Count
Возвращает число элементов в коллекции.
public override int Count
Перечисление SPPhoneNotificationSubscriberType
Указывает тип устройства, который может получать уведомления.
| Уведомление | Устройство |
|---|---|
|
WP7 |
Windows Phone 7.5 |
|
Custom |
Все устройства, отличные от Windows Phone 7.5 |
Перечисление SPPhoneNotificationType
Указывает тип уведомления.
-None -Tile -Toast -Raw
Класс SPWeb
Были добавлены следующие члены этого класса.
Методы
DoesPhoneNotificationSubscriberExist
Получает значение, указывающее, является ли текущий пользователь подписчика для указанного экземпляра указанное приложение.
public bool DoesPhoneNotificationSubscriberExist(Guid deviceAppInstanceId)
GetPhoneNotificationSubscriber
Получает подписчиков уведомлений с помощью указанного приложения и телефон идентификаторы из списка хранилища подписок уведомлений веб-сайта.
public SPPhoneNotificationSubscriber GetPhoneNotificationSubscriber(Guid deviceAppInstanceId)
Параметры
deviceAppInstanceId это идентификатор экземпляра приложения на конкретных телефон или устройство.
Сведения о см класс SPPhoneNotificationSubscriber ранее в этом документе.
GetPhoneNotificationSubscribers (перегрузка)
Получает коллекцию подписчиков уведомлений из списка хранилища подписок уведомлений веб-сайта, при необходимости фильтрации на код приложений телефона и, возможно, также на одном из следующих значений: некоторые пользовательские аргументы или пользователя.
public SPPhoneNotificationSubscriberCollection GetPhoneNotificationSubscribers(string customArgs)
Примечание.
[!Примечание] Имя объектной модели клиента GetPhoneNotificationSubscribersByArgs.
public SPPhoneNotificationSubscriberCollection GetPhoneNotificationSubscribers(string user)
Примечание.
[!Примечание] Имя объектной модели клиента GetPhoneNotificationSubscribersByUser.
Параметры
customArgs это дополнительные настраиваемые сведения, могут использовать несколько приложений с поддержкой уведомлений.
user это пользователь, зарегистрированных для уведомлений.
Сведения о см класс SPPhoneNotificationSubscriberCollection ранее в этом документе.
RegisterPhoneNotificationSubscriber
Регистрирует приложение phone на телефоне для получения уведомлений.
public SPPhoneNotificationSubscriber RegisterPhoneNotificationSubscriber(SPPhoneNotificationSubscriberType subscriberType, Guid deviceAppInstanceId, string serviceToken)
Параметры
subscriberType это тип устройства, такие как Windows Phone 7.
deviceAppInstanceId это идентификатор экземпляра приложения на конкретных телефон или устройство.
serviceToken это маркер, используемый службой уведомлений, который отправляет уведомления для подписчиков.
Сведения о SPPhoneNotificationSubscriberTypeсодержатся в этом документе.
UnregisterPhoneNotificationSubscriber
Отменяет регистрацию приложение phone на телефоне получать уведомления.
public void UnregisterPhoneNotificationSubscriber(Guid deviceAppInstanceId)
Параметры
deviceAppInstanceId это идентификатор экземпляра приложения на конкретных телефон или устройство.
Свойства
PhoneNotificationSubscribers (только для чтения)
Получает коллекцию всех телефона подписчиков уведомлений в хранилище подписчика веб-сайта.
public SPPhoneNotificationSubscriberCollection PhoneNotificationSubscribers
Сведения о SPPhoneNotificationSubscriberCollection класса содержатся выше в этом документе.
Класс WP7NotificationTileContent
Представляет содержимое заголовков уведомлений.
public sealed class WP7NotificationTileContent : SPPhoneNotificationContent
Конструкторы
Инициализирует новый экземпляр класса WP7NotificationTileContent.
public WP7NotificationTileContent()
Методы
PreparePayload
Преобразует содержимое в массив Byte, отправляемые по сети в службу уведомлений.
protected internal override byte[] PreparePayload();
Свойства
Count
Получает или задает число уведомлений. Должна быть от -1 до 99 включительно.
public int Count
Для свойства значение -1, значение счетчика на иконку остаются без изменений.
Title
Получает или задает заголовок заголовков уведомлений.
public string Title
BackgroundImagePath
Получает или задает путь к плитки фонового изображения.
public string BackgroundImagePath
BackBackgroundImagePath
Получает или задает фоновое изображение задней стороне транспонирования заголовков.
public string BackBackgroundImagePath
BackContent
Получает или задает содержимое обратной стороне транспонирования заголовков.
public string BackContent
BackTitle
Получает или задает заголовок, отображаемый на задней стороне транспонирования заголовков.
public string BackTitle
TileId
Получает или задает идентификатор фрагмента.
public string TileId
Класс WP7NotificationToastContent
Представляет содержимое всплывающее уведомление.
public sealed class WP7NotificationToastContent : SPPhoneNotificationContent
Конструкторы
Инициализирует новый экземпляр класса WP7NotificationToastContent.
public WP7NotificationToastContent()
Методы
PreparePayload
Преобразует содержимое в массив Byte, отправляемые по сети в службу уведомлений.
protected internal override byte[] PreparePayload();
Свойства
Сообщение
Получает или задает сообщение всплывающее уведомление.
public string Message
Title
Получает или задает заголовок всплывающее уведомление.
public string Title
Param
Получает или задает пользовательских параметров данных, который передается в приложение-получатель, если пользователь отвечает на всплывающее уведомление.
public string Param
Это свойство можно использовать для передачи сведений в получающее приложение, например URL-адрес или набор пар "имя значение".
Класс WP7NotificationRawContent
Представляет содержимое необработанное уведомление.
public sealed class WP7NotificationRawContent : SPPhoneNotificationContent
Конструкторы
Инициализирует новый экземпляр класса WP7NotificationRawContent.
public WP7NotificationRawContent()
Методы
PreparePayload
Преобразует содержимое в массив байтов, который отправляется по сети в службу уведомлений.
protected internal override byte[] PreparePayload();
Свойства
Сообщение
Получает или задает сообщение необработанное уведомление.
public string Message
Класс WP7PhoneNotificationResponse
Отображает результат при попытке отправить уведомление подписчика Windows Phone 7.
public WP7PhoneNotificationResponse(SPPhoneNotificationType notificationType, HttpWebResponse response)
Параметры
notificationType тип уведомлений, такие как всплывающее или плитки.
response это объект HTTP-ответа, который был создан на сервере.
Дополнительные сведения о SPPhoneNotificationTypeсодержатся в этом документе.
Свойства
NotificationStatus (только для чтения)
Получает состояние уведомления, например, успешное или неудачное.
public string NotificationStatus
DeviceConnectionStatus (только для чтения)
Получает состояние устройства во время уведомления.
public string DeviceConnectionStatus
SubscriptionStatus (только для чтения)
Состояние подписки на устройство во время уведомления.
public string SubscriptionStatus
MessageId (только для чтения)
Получает идентификатор сообщения, отправленного в уведомлении.
public string MessageId