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

Wenn diese Methode zurückgegeben wird, enthält true sie, ob die Eigenschaft bereits vorhanden ist; false wenn der Aufruf die Eigenschaft erstellt hat.

Gibt zurück

Die angeforderte SharedPropertyGroup.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie mithilfe der CreatePropertyGroup Methode einen Gruppen-Manager für freigegebene Eigenschaften 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

Wenn dwIsoModeSie beim Abrufen und Festlegen von Vorgängen festlegen, können Sie entweder festlegen, dass sperrungseigenschaften atomisiert werden sollen, indem SetGetSie Eigenschaften über die Dauer des Methodenaufrufs sperren, indem Sie angeben Method.

Vorsicht

Verwenden Method Sie dies nicht, wenn Sie eine Eigenschaftengruppe in einem Konstruktor erstellen. Dies kann zu einem Deadlock führen.

Wenn der für den Veröffentlichungsmodus angegebene Modus ist dwRelModeProcess, wird die angegebene name Eigenschaft für die Lebensdauer des Prozesses aktiv gehalten.

Gilt für: