SharedPropertyGroupManager.CreatePropertyGroup Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Ищет или создает группу свойств с заданными сведениями.
public:
System::EnterpriseServices::SharedPropertyGroup ^ CreatePropertyGroup(System::String ^ name, System::EnterpriseServices::PropertyLockMode % dwIsoMode, System::EnterpriseServices::PropertyReleaseMode % dwRelMode, [Runtime::InteropServices::Out] bool % fExist);
public System.EnterpriseServices.SharedPropertyGroup CreatePropertyGroup (string name, ref System.EnterpriseServices.PropertyLockMode dwIsoMode, ref System.EnterpriseServices.PropertyReleaseMode dwRelMode, out bool fExist);
member this.CreatePropertyGroup : string * PropertyLockMode * PropertyReleaseMode * bool -> System.EnterpriseServices.SharedPropertyGroup
Public Function CreatePropertyGroup (name As String, ByRef dwIsoMode As PropertyLockMode, ByRef dwRelMode As PropertyReleaseMode, ByRef fExist As Boolean) As SharedPropertyGroup
Параметры
- name
- String
Имя запрошенного свойства.
- dwIsoMode
- PropertyLockMode
Одно из значений перечисления PropertyLockMode. Дополнительные сведения см. в разделе "Примечания".
- dwRelMode
- PropertyReleaseMode
Одно из значений перечисления PropertyReleaseMode. Дополнительные сведения см. в разделе "Примечания".
- fExist
- Boolean
При возвращении метод содержит значение true
, если свойство уже существует; или значение false
, если свойство было создано при вызове.
Возвращаемое значение
Запрошенный SharedPropertyGroup.
Примеры
В следующем примере кода показано, как использовать CreatePropertyGroup
метод для создания диспетчера групп общих свойств.
// Create a shared property group.
SharedPropertyGroup^ group =
groupManager->CreatePropertyGroup( "Receipts", lockMode, releaseMode, groupExists );
// Create a shared property group.
SharedPropertyGroup group = groupManager.CreatePropertyGroup("Receipts",
ref lockMode, ref releaseMode, out groupExists);
' Create a shared property group.
Dim group As SharedPropertyGroup = groupManager.CreatePropertyGroup("Receipts", lockMode, releaseMode, groupExists)
Комментарии
Используя dwIsoMode
, во время операций получения и задания можно либо сделать свойства блокировки атомарными, указав SetGet, либо заблокировать свойства на протяжении всего вызова метода, указав Method.
Внимание!
Не используйте Method при создании группы свойств в конструкторе, что может привести к взаимоблокировке.
Если режим выпуска, указанный для dwRelMode
, имеет значение Process, свойство, указанное параметром name
, хранится в активном режиме в течение всего времени существования процесса.