SharedPropertyGroupManager.CreatePropertyGroup Methode

Definition

Sucht oder erstellt eine Eigenschaftengruppe mit den angegebenen Informationen.

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

Parameter

name
String

Der Name der angeforderten Eigenschaft.

dwIsoMode
PropertyLockMode

Einer der PropertyLockMode-Werte. Weitere Informationen finden Sie im Abschnitt Hinweise.

dwRelMode
PropertyReleaseMode

Einer der PropertyReleaseMode-Werte. Weitere Informationen finden Sie im Abschnitt Hinweise.

fExist
Boolean

Enthält nach dem Beenden dieser Methode true, wenn die Eigenschaft bereits vorhanden war, und false, wenn die Eigenschaft durch den Aufruf erstellt wurde.

Gibt zurück

Der angeforderte SharedPropertyGroup.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie mit der CreatePropertyGroup -Methode einen Freigegebenen Eigenschaftengruppen-Manager erstellen.

// 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)

Hinweise

Mithilfe von dwIsoModekönnen Sie bei Get- und Set-Vorgängen entweder festlegen, ob sperrungseigenschaften atomar sind, indem Sie angeben SetGet, oder Eigenschaften über die Dauer des Methodenaufrufs sperren, indem Sie angeben Method.

Achtung

Verwenden Method Sie beim Erstellen einer Eigenschaftengruppe in einem Konstruktor nicht, da dies zu einem Deadlock führen kann.

Wenn der für dwRelMode angegebene Freigabemodus ist, wird Processdie von name angegebene Eigenschaft für die Lebensdauer des Prozesses am Leben gehalten.

Gilt für: