IUserProfileCardService — интерфейс

Описывает сервис для работы с карточкой настроек пользователя.

Синтаксис

public interface IUserProfileCardService

Методы

Имя Описание

GetCertificate(String)

Получает сертификат пользователя с указанным именем учетной записи.

GetSetting(Int32)

Получает из профиля пользователя настройку указанного типа.

GetSetting(Int32, Object)

Получает из профиля пользователя настройку указанного типа, в случае её отсутствия, возвращает значение второго параметра.

GetSetting(Int32, Object, Guid)

Получает из профиля пользователя настройку указанного типа. Параметр objectId конкретизирует настройку, в случае присутствии нескольких однотипных настроек.

SetCertificate(String, X509Certificate2)

Задаёт сертификат указанному пользователю.

SetPersonalFolder(String, FoldersFolder)

Задаёт значение личной папки пользователя в карточке.

SetSetting(Int32, Object)

Сохраняет в профиль настройку заданного типа.

SetSetting(Int32, Guid, Object)

Сохраняет в профиль настройку с заданным идентификатором.

Примеры

приведён пример простого использования методов сервиса — запись и чтение настроек

(1)

int settingType = 999;
Guid objectID = Guid.NewGuid(); (2)

iUserProfileCardService.SetSetting(settingType, objectID, "Белый"); (3)

string value = (iUserProfileCardService.GetSetting(settingType, string.Empty, objectID) as string); (4)
Console.WriteLine(value);
1 Инициализация контекста объектов.
2 Задаем тип свойства и идентификатор.
3 Задаем значение свойства.
4 Получаем значение свойства, если свойство отсутствует, что в контексте примера конечно невозможно, то вернется пуста строка.

Ещё один пример использования сервиса — создание и установка личной папки пользователя

(1)

IStateService stateService = objectContext.GetService<IStateService>();
IUserProfileCardService iUserProfileCardService = objectContext.GetService<IUserProfileCardService>(); (2)

StaffEmployee staffEmployee = staffService.Get(new Guid("00000000-0000-0000-0000-000000000000")); (3)

FoldersFolder foldersFolder = objectContext.GetObject<FoldersFolder>(new Guid("FFFFFFFF-FFFF-0003-FFFF-000000000000")); (4)

FoldersFolder newfoldersFolder = new FoldersFolder(); (5)
newfoldersFolder.Name = "OtherFolder";

foldersFolder.Folders.Add(newfoldersFolder); (6)
objectContext.AcceptChanges();

iUserProfileCardService.SetPersonalFolder(staffEmployee.AccountName, newfoldersFolder); (7)
objectContext.AcceptChanges();
1 Инициализация контекста объектов.
2 Получение сервисов по работе со справочником сотрудников и профилями пользователей.
3 Получение пользователя с идентификатором 00000000-0000-0000-0000-000000000000.
4 Получение корневой папки "Папки".
5 Создание новой папки с названием "OtherFolder".
6 Добавление к корневой созданной папки и сохранение контекста.
7 Назначение персональной папки.