Compartilhar via


UserPermissionCollection.Add Método

Definição

Sobrecargas

Add(String)

Adiciona um novo usuário ao formulário atual.

Add(String, PermissionType)

Adiciona um novo usuário com as permissões especificadas.

Add(String, DateTime)

Adicione um novo usuário ao formulário atual com uma data de validade.

Add(String, PermissionType, DateTime)

Cria um novo conjunto de permissões no formulário atual para o usuário especificado com as permissões especificadas e uma data de validade.

Add(String)

Adiciona um novo usuário ao formulário atual.

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId);
abstract member Add : string -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String) As UserPermission

Parâmetros

userId
String

O endereço de email no formato user@domain.com do usuário a quem as permissões no formulário atual estão sendo concedidas.

Retornos

Um UserPermission objeto que representa o usuário especificado.

Exceções

O parâmetro passado para esse método é uma referência nula (Nada no Visual Basic).

O parâmetro passado para esse método não é válido. Por exemplo, ele é do tipo ou formato errado.

O modelo de formulário não está configurado para Total Confiança usando a categoria Segurança e Confiança da caixa de diálogo Opções de Formulário.

Exemplos

No exemplo a seguir, clicar no controle Botão obtém o UserPermissionsCollection para o formulário atual e, em seguida, adiciona um novo usuário.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   this.Permission.UserPermissions.Add("someone@example.com");
}
Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Me.Permission.UserPermissions.Add("someone@example.com")
End Sub

Comentários

This member can be accessed only by forms opened from a form template that has been configured to run with full trust using the Security and Trust category of the Form Options dialog box. This member requires full trust for the immediate caller and cannot be used by partially trusted code. For more information, see "Using Libraries from Partially Trusted Code" on MSDN.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

Aplica-se a

Add(String, PermissionType)

Adiciona um novo usuário com as permissões especificadas.

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId, Microsoft::Office::InfoPath::PermissionType permission);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId, Microsoft.Office.InfoPath.PermissionType permission);
abstract member Add : string * Microsoft.Office.InfoPath.PermissionType -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String, permission As PermissionType) As UserPermission

Parâmetros

userId
String

O endereço de email no formato user@domain.com do usuário a quem as permissões no formulário atual estão sendo concedidas.

permission
PermissionType

As permissões no formulário atual que estão sendo concedidas ao usuário especificado como uma combinação de um ou mais PermissionType valores.

Retornos

Um UserPermissionobjeto .que representa o usuário especificado.

Exceções

O parâmetro passado para esse método é uma referência nula (Nada no Visual Basic).

O parâmetro passado para esse método não é válido. Por exemplo, ele é do tipo ou formato errado.

O modelo de formulário não está configurado para Total Confiança usando a categoria Segurança e Confiança da caixa de diálogo Opções de Formulário.

Exemplos

No exemplo a seguir, clicar no controle Botão obtém o UserPermissionsCollection para o formulário atual e, em seguida, adiciona e atribui um usuário ao nível de acesso do Controle Completo.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   this.Permission.UserPermissions.Add("someone@example.com", 
      PermissionType.FullControl);
}
Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Me.Permission.UserPermissions.Add("someone@example.com", _
      PermissionType.FullControl)
End Sub

Comentários

This member can be accessed only by forms opened from a form template that has been configured to run with full trust using the Security and Trust category of the Form Options dialog box. This member requires full trust for the immediate caller and cannot be used by partially trusted code. For more information, see "Using Libraries from Partially Trusted Code" on MSDN.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

Aplica-se a

Add(String, DateTime)

Adicione um novo usuário ao formulário atual com uma data de validade.

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId, DateTime expirationDate);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId, DateTime expirationDate);
abstract member Add : string * DateTime -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String, expirationDate As DateTime) As UserPermission

Parâmetros

userId
String

O endereço de email no formato user@domain.com do usuário a quem as permissões no formulário atual estão sendo concedidas.

expirationDate
DateTime

A data de validade das permissões que estão sendo concedidas como um valor System.DateTime .

Retornos

Um UserPermission objeto que representa o usuário especificado.

Exceções

O parâmetro passado para esse método é uma referência nula (Nada no Visual Basic).

O parâmetro passado para esse método não é válido. Por exemplo, ele é do tipo ou formato errado.

O modelo de formulário não está configurado para Total Confiança usando a categoria Segurança e Confiança da caixa de diálogo Opções de Formulário.

Exemplos

No exemplo a seguir, clicar no controle Botão obtém o UserPermissionsCollection para o formulário atual, adiciona um novo usuário ao formulário atual e define uma data de validade de dois dias a partir da data atual.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   string strExpirationDate = DateTime.Today.AddDays(2).ToString();
   DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

   this.Permission.UserPermissions.Add("someone@example.com",
      dtExpirationDate);
}
Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Dim strExpirationDate As String = _
      DateTime.Today.AddDays(2).ToString()
   dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

   Me.Permission.UserPermissions.Add("someone@example.com", _
      dtExpirationDate)
End Sub

Comentários

This member can be accessed only by forms opened from a form template that has been configured to run with full trust using the Security and Trust category of the Form Options dialog box. This member requires full trust for the immediate caller and cannot be used by partially trusted code. For more information, see "Using Libraries from Partially Trusted Code" on MSDN.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

Aplica-se a

Add(String, PermissionType, DateTime)

Cria um novo conjunto de permissões no formulário atual para o usuário especificado com as permissões especificadas e uma data de validade.

public:
 abstract Microsoft::Office::InfoPath::UserPermission ^ Add(System::String ^ userId, Microsoft::Office::InfoPath::PermissionType permission, DateTime expirationDate);
public abstract Microsoft.Office.InfoPath.UserPermission Add (string userId, Microsoft.Office.InfoPath.PermissionType permission, DateTime expirationDate);
abstract member Add : string * Microsoft.Office.InfoPath.PermissionType * DateTime -> Microsoft.Office.InfoPath.UserPermission
Public MustOverride Function Add (userId As String, permission As PermissionType, expirationDate As DateTime) As UserPermission

Parâmetros

userId
String

O endereço de email no formato user@domain.com do usuário a quem as permissões no formulário atual estão sendo concedidas.

permission
PermissionType

As permissões no formulário atual que estão sendo concedidas ao usuário especificado como uma combinação de um ou mais PermissionType valores.

expirationDate
DateTime

A data de validade das permissões que estão sendo concedidas como um valor System.DateTime .

Retornos

Um UserPermission que representa o usuário especificado.

Exceções

O valor DateTime fornecido é inválido.

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

Os parâmetros passados para esse método não são válidos. Por exemplo, eles são do tipo ou formato errado.

O modelo de formulário não está configurado para Total Confiança usando a categoria Segurança e Confiança da caixa de diálogo Opções de Formulário.

Exemplos

No exemplo a seguir, clicar no controle Botão obtém o UserPermissionsCollection para o formulário atual, adiciona e atribui um usuário ao nível de acesso do Controle Completo e define uma data de validade de dois dias a partir da data atual.

public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
   string strExpirationDate = DateTime.Today.AddDays(2).ToString();
   DateTime dtExpirationDate = DateTime.Parse(strExpirationDate);

   this.Permission.UserPermissions.Add("someone@example.com", 
      PermissionType.FullControl, dtExpirationDate);
}
Public Sub CTRL1_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Dim strExpirationDate As String = _
      DateTime.Today.AddDays(2).ToString()
   dtExpirationDate As DateTime = DateTime.Parse(strExpirationDate)

   Me.Permission.UserPermissions.Add("someone@example.com", _
      PermissionType.FullControl, dtExpirationDate)
End Sub

Comentários

This member can be accessed only by forms opened from a form template that has been configured to run with full trust using the Security and Trust category of the Form Options dialog box. This member requires full trust for the immediate caller and cannot be used by partially trusted code. For more information, see "Using Libraries from Partially Trusted Code" on MSDN.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

Aplica-se a