SharedPropertyGroupManager.CreatePropertyGroup メソッド

.NET Framework クラス ライブラリ リファレンス

SharedPropertyGroupManager.CreatePropertyGroup メソッド

指定された情報でプロパティ グループを検索または作成します。

名前空間: System.EnterpriseServices
アセンブリ: System.EnterpriseServices (system.enterpriseservices.dll 内)
構文

Visual Basic (宣言)

Public Function CreatePropertyGroup ( _
    name As String, _
    ByRef dwIsoMode As PropertyLockMode, _
    ByRef dwRelMode As PropertyReleaseMode,
 _
    <OutAttribute> ByRef fExist As Boolean
 _
) As SharedPropertyGroup

Visual Basic (使用法)

Dim instance As SharedPropertyGroupManager
Dim name As String
Dim dwIsoMode As PropertyLockMode
Dim dwRelMode As PropertyReleaseMode
Dim fExist As Boolean
Dim returnValue As SharedPropertyGroup

returnValue = instance.CreatePropertyGroup(name, dwIsoMode, dwRelMode, fExist)

C#

public SharedPropertyGroup CreatePropertyGroup (
    string name,
    ref PropertyLockMode dwIsoMode,
    ref PropertyReleaseMode dwRelMode,
    out bool fExist
)

C++

public:
SharedPropertyGroup^ CreatePropertyGroup (
    String^ name, 
    PropertyLockMode% dwIsoMode, 
    PropertyReleaseMode% dwRelMode, 
    [OutAttribute] bool% fExist
)

J#

public SharedPropertyGroup CreatePropertyGroup (
    String name, 
    /** @ref */ PropertyLockMode dwIsoMode, 
    /** @ref */ PropertyReleaseMode dwRelMode, 
    /** @attribute OutAttribute() */ /** @ref */ boolean fExist
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

name

要求されたプロパティの名前。

dwIsoMode

PropertyLockMode 値の 1 つ。詳細については「解説」を参照してください。

dwRelMode

PropertyReleaseMode 値の 1 つ。詳細については「解説」を参照してください。

fExist

このメソッドが返されるとき、指定したプロパティが既に存在している場合は true、呼び出しによってプロパティが作成された場合は false が格納されています。

戻り値
要求された SharedPropertyGroup。

解説

dwIsoMode を使用すると、取得操作および設定操作の際に、SetGet を指定してロック プロパティを分割不可能にするか、Method を指定してメソッド呼び出しの間、プロパティをロックするかのどちらかを選択できます。

注意
コンストラクタ内でプロパティ グループを作成する場合は、Method を使用しないでください。これを行うと、デッドロックが発生する可能性があります。

dwRelMode に指定したリリース モードが Process である場合、そのプロセスの有効期間の間は name によって指定したプロパティの有効状態が維持されます。

使用例

CreatePropertyGroup メソッドを使用して、共有プロパティ グループ マネージャを作成する方法を次のコード例に示します。

Visual Basic

' Create a shared property group.
Dim group As SharedPropertyGroup = groupManager.CreatePropertyGroup("Receipts",
 lockMode, releaseMode, groupExists)

C#

// Create a shared property group.
SharedPropertyGroup group = groupManager.CreatePropertyGroup("Receipts"
,
                           ref lockMode, ref releaseMode, out groupExists);

C++

// Create a shared property group.
SharedPropertyGroup^ group =
   groupManager->CreatePropertyGroup( "Receipts",  lockMode,  releaseMode,
  groupExists );

J#

// Create a shared property group.
SharedPropertyGroup group = groupManager.CreatePropertyGroup("Receipts"
,
    lockMode, releaseMode, groupExists);

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
SharedPropertyGroupManager クラス
SharedPropertyGroupManager メンバ
System.EnterpriseServices 名前空間