SharedPropertyGroupManager.CreatePropertyGroup Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Localiza ou cria um grupo de propriedades com as informações fornecidas.
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
Parâmetros
- name
- String
O nome da propriedade solicitada.
- dwIsoMode
- PropertyLockMode
Um dos valores de PropertyLockMode. Consulte a seção Comentários para obter mais informações.
- dwRelMode
- PropertyReleaseMode
Um dos valores de PropertyReleaseMode. Consulte a seção Comentários para obter mais informações.
- fExist
- Boolean
Ao retornar, este método conterá true
se a propriedade já existir; false
se a chamada tiver criado a propriedade.
Retornos
O SharedPropertyGroup solicitado.
Exemplos
O exemplo de código a seguir mostra como usar o CreatePropertyGroup
método para criar um gerenciador de grupo de propriedades compartilhado.
// 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)
Comentários
Usando dwIsoMode
, durante as operações get e set, você pode optar por tornar as propriedades de bloqueio atômicas especificando SetGetou bloquear propriedades durante a chamada do método especificando Method.
Cuidado
Não use Method ao criar um grupo de propriedades em um construtor, fazer isso pode resultar em um deadlock.
Se o modo de versão especificado para dwRelMode
for Process, a propriedade especificada por name
será mantida ativa durante o tempo de vida do processo.