UserPermissionCollection.Add Methode

Referenz

Definition

Namespace:: Microsoft.Office.InfoPath

Assembly:: Microsoft.Office.InfoPath.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Add(String)	Fügt dem aktuellen Formular einen neuen Benutzer hinzu.
Add(String, PermissionType)	Fügt einen neuen Benutzer mit den angegebenen Berechtigungen hinzu.
Add(String, DateTime)	Fügt dem aktuellen Formular einen neuen Benutzer mit Ablaufdatum hinzu.
Add(String, PermissionType, DateTime)	Erstellt eine neue Berechtigungsgruppe für das aktuelle Formular für den angegebenen Benutzer mit den angegebenen Berechtigungen und einem Ablaufdatum.

Add(String)

Fügt dem aktuellen Formular einen neuen Benutzer hinzu.

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

Parameter

userId: String

Die E-Mail-Adresse im Format user@domain.com des Benutzers, dem Berechtigungen für das aktuelle Formular erteilt werden.

Gibt zurück

UserPermission

Ein UserPermission -Objekt, das den angegebenen Benutzer darstellt.

Ausnahmen

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

SecurityException

Die Formularvorlage ist in der Kategorie Sicherheit und Vertrauensstellung der Dialogfeldes Formularoptionen nicht auf Voll Vertrauenswürdig festgelegt.

Beispiele

Im folgenden Beispiel wird durch Klicken auf das Steuerelement Schaltfläche das UserPermissionsCollection-Element für das aktuelle Formular abgerufen und dann ein neuer Benutzer hinzugefügt.

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

Hinweise

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die über eine Formularvorlage geöffnet wurden, die mithilfe der Kategorie "Sicherheit und Vertrauensstellung" im Dialogfeld "Formularoptionen" so konfiguriert wurde, dass sie mit voller Vertrauenswürdigkeit ausgeführt wird. Dieses Mitglied erfordert die volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer und kann von teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie auf MSDN unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code".

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

Add(String, PermissionType)

Fügt einen neuen Benutzer mit den angegebenen Berechtigungen hinzu.

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

Parameter

userId: String

Die E-Mail-Adresse im Format user@domain.com des Benutzers, dem Berechtigungen für das aktuelle Formular erteilt werden.

permission: PermissionType

Die Berechtigungen für das aktuelle Formular, die dem angegebenen Benutzer als Kombination aus einem oder PermissionType mehreren Werten gewährt werden.

Gibt zurück

UserPermission

Ein UserPermissionOBJEKT, das den angegebenen Benutzer darstellt.

Ausnahmen

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

SecurityException

Die Formularvorlage ist in der Kategorie Sicherheit und Vertrauensstellung der Dialogfeldes Formularoptionen nicht auf Voll Vertrauenswürdig festgelegt.

Beispiele

Im folgenden Beispiel wird durch Klicken auf das Button-Steuerelement die UserPermissionsCollection für das aktuelle Formular abgerufen. Anschließend wird der Zugriffsebene Vollzugriff ein Benutzer hinzugefügt und zugewiesen.

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

Hinweise

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

Add(String, DateTime)

Fügt dem aktuellen Formular einen neuen Benutzer mit Ablaufdatum hinzu.

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

Parameter

userId: String

Die E-Mail-Adresse im Format user@domain.com des Benutzers, dem Berechtigungen für das aktuelle Formular erteilt werden.

expirationDate: DateTime

Das Ablaufdatum für die Berechtigungen, die erteilt werden, als System.DateTime-Wert.

Gibt zurück

UserPermission

Ein UserPermission -Objekt, das den angegebenen Benutzer darstellt.

Ausnahmen

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.

SecurityException

Die Formularvorlage ist in der Kategorie Sicherheit und Vertrauensstellung der Dialogfeldes Formularoptionen nicht auf Voll Vertrauenswürdig festgelegt.

Beispiele

Im folgenden Beispiel wird durch Klicken auf das Steuerelement Schaltfläche das UserPermissionsCollection-Element für das aktuelle Formular abgerufen. Dann wird dem aktuellen Formular ein neuer Benutzer hinzugefügt und ein Ablaufdatum von zwei Tagen ab dem aktuellen Datum festgelegt.

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

Hinweise

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

Add(String, PermissionType, DateTime)

Erstellt eine neue Berechtigungsgruppe für das aktuelle Formular für den angegebenen Benutzer mit den angegebenen Berechtigungen und einem Ablaufdatum.

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

Parameter

userId: String

Die E-Mail-Adresse im Format user@domain.com des Benutzers, dem Berechtigungen für das aktuelle Formular erteilt werden.

permission: PermissionType

Die Berechtigungen für das aktuelle Formular, die dem angegebenen Benutzer als Kombination aus einem oder PermissionType mehreren Werten gewährt werden.

expirationDate: DateTime

Das Ablaufdatum für die Berechtigungen, die erteilt werden, als System.DateTime-Wert.

Gibt zurück

UserPermission

Eine UserPermission , die den angegebenen Benutzer darstellt.

Ausnahmen

FormatException

Der bereitgestellte DateTime-Wert ist ungültig.

ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (Nothing in Visual Basic).

ArgumentException

Die an diese Methode übergebenen Parameter sind nicht gültig. Die Parameter weisen beispielsweise den falschen Typ oder das falsche Format auf.

SecurityException

Die Formularvorlage ist in der Kategorie Sicherheit und Vertrauensstellung der Dialogfeldes Formularoptionen nicht auf Voll Vertrauenswürdig festgelegt.

Beispiele

Im folgenden Beispiel wird durch Klicken auf das Button-Steuerelement die UserPermissionsCollection für das aktuelle Formular abgerufen, ein Benutzer hinzugefügt und der Zugriffsebene Vollzugriff zugewiesen und ein Ablaufdatum von zwei Tagen ab dem aktuellen Datum festgelegt.

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

Hinweise

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

Freigeben über

UserPermissionCollection.Add Methode

Definition

Überlädt

Add(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Add(String, PermissionType)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Add(String, DateTime)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Add(String, PermissionType, DateTime)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Feedback

Zusätzliche Ressourcen