SharedPropertyGroupManager.CreatePropertyGroup(String, PropertyLockMode, PropertyReleaseMode, Boolean) Метод

Определение

Ищет или создает группу свойств с заданными сведениями.Finds or creates a property group with the given information.

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

Имя запрошенного свойства.The name of requested property.

dwIsoMode
PropertyLockMode

Одно из значений перечисления PropertyLockMode.One of the PropertyLockMode values. Дополнительные сведения см. в разделе "Примечания".See the Remarks section for more information.

dwRelMode
PropertyReleaseMode

Одно из значений перечисления PropertyReleaseMode.One of the PropertyReleaseMode values. Дополнительные сведения см. в разделе "Примечания".See the Remarks section for more information.

fExist
Boolean

При возвращении метод содержит значение true, если свойство уже существует; или значение false, если свойство было создано при вызове.When this method returns, contains true if the property already existed; false if the call created the property.

Возвращаемое значение

SharedPropertyGroup

Запрошенный SharedPropertyGroup.The requested SharedPropertyGroup.

Примеры

В следующем примере кода показано, как использовать CreatePropertyGroup метод для создания общего диспетчера групп свойств.The following code example shows how to use the CreatePropertyGroup method to create a shared property group manager.

// 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 , во время операций Get и Set, можно либо сделать свойства блокировки атомарными путем указания SetGet , либо для блокировки свойств на протяжении вызова метода, указав Method .Using dwIsoMode, during get and set operations, you can either choose to make locking properties atomic by specifying SetGet, or to lock properties over the duration of the method call by specifying Method.

Внимание!

Не используйте Method при создании группы свойств в конструкторе, так как это может привести к взаимоблокировке.Do not use Method when creating a property group in a constructor, doing so can result in a deadlock.

Если режим выпуска, заданный dwRelMode для Process , имеет значение, свойство, заданное параметром, сохраняется в name активном состоянии в течение времени существования процесса.If the release mode specified for dwRelMode is Process, the property specified by name is held alive for the lifetime of the process.

Применяется к