User.IsUserMemberOf(String) Methode
Definition
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.
Ruft ab, ob der aktuelle Benutzer ein Mitglied der angegebenen Gruppe ist.
public:
abstract bool IsUserMemberOf(System::String ^ groupName);
public abstract bool IsUserMemberOf(string groupName);
abstract member IsUserMemberOf : string -> bool
Public MustOverride Function IsUserMemberOf (groupName As String) As Boolean
Parameter
- groupName
- String
Der Gruppenname im Format Domäne\Gruppenname.
Gibt zurück
true, wenn der aktuelle Benutzer Mitglied der angegebenen Gruppe ist; andernfalls false.
Ausnahmen
Der an diese Methode übergebene Parameter ist ein NULL-Verweis (Nothing in Visual Basic).
Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf.
Beispiele
Im folgenden Beispiel wird beim Klicken auf das Steuerelement Schaltfläche angezeigt, ob der aktuelle Benutzer ein Mitglied der angegebenen Gruppe ist.
public void CTRL1_Clicked(object sender, ClickedEventArgs e)
{
MessageBox.Show(
this.Application.User.IsUserMemberOf(
"CONTOSO\\Users").ToString());
}
Public Sub CTRL1_Clicked(ByVal sender As Object, _
ByVal e As ClickedEventArgs)
MessageBox.Show( _
Me.Application.User.IsUserMemberOf("CONTOSO\\Users").ToString())
End Sub
Hinweise
Obwohl die IsUserMemberOf(String) Methode als Sicherheitsstufe 2 gekennzeichnet ist, ist sie nicht immer zugänglich. Wenn ein Aufruf der IsUserMemberOf(String) -Methode erfolgt, führt InfoPath zunächst eine Sicherheitsüberprüfung durch, um zu bestimmen, ob der Zugriff auf diese Methode zulässig ist. Die Sicherheitsprüfung bestätigt, ob der aufrufende Code vertrauenswürdig ist oder nicht, und ermittelt die Position dieses Codes.
Wenn der aufrufende Code vertrauenswürdig ist (z. B. wenn die IsUserMemberOf(String) Methode aus einer installierten oder signierten InfoPath-Formularvorlage oder aus vertrauenswürdigem externem Code wie einer ausführbaren Datei auf dem lokalen Computer aufgerufen wird), ermöglicht InfoPath vollzugriff auf die IsUserMemberOf(String) Methode.
Wenn der aufrufende Code nicht vertrauenswürdig ist, z. B. wenn der Aufruf von einer domänenbasierten InfoPath-Formularvorlage stammt, überprüft InfoPath zuerst, woher der Aufruf erfolgt. Wenn der Aufruf von Code stammt, der in einer InfoPath-Formularvorlage unter einer URL wie "http://www.contoso.com/example.xsn" nicht vertrauenswürdig ist, erfolgt der Aufruf aus der Internetzone. InfoPath verweigert den Zugriff auf die IsUserMemberOf(String) -Methode für alle Aufrufe, die nicht vertrauenswürdig sind, die aus der Internetzone stammen. Wenn der Aufruf von einer URL wie "http://contoso/example.xsn" stammt, stammt der Aufruf aus der Intranetzone. Bei einem Aufruf, der von der Intranetzone aus nicht vertrauenswürdig ist, überprüft InfoPath, ob die Internet-Explorer Benutzerauthentifizierungseinstellungen die automatische Anmeldung zulassen (nur in der Intranetzone oder für jede Anmeldung). Wenn Internet Explorer für die automatische Anmeldung konfiguriert ist, überprüft InfoPath die Gruppenmitgliedschaft des Benutzers. Wenn die Gruppenmitgliedschaft öffentlich ist, ermöglicht InfoPath den Vollzugriff auf die IsUserMemberOf(String) -Methode. Wenn die Gruppenmitgliedschaft nicht vollständig öffentlich ist, blendet InfoPath das Ergebnis aus. Das heißt, InfoPath behandelt die Gruppenmitgliedschaft so, als ob sie nicht sichtbar wäre. Der Rückgabewert ist in diesem Fall immer false , da die Gruppenmitgliedschaft nicht öffentlich ist. InfoPath meldet nicht, dass der Zugriff verweigert wird.
Hinweis: Gruppenmitgliedschaftsinformationen sind vollständig öffentlich, wenn der Zugriff darauf zulässig ist und die Informationen für alle nicht anonymen Benutzer sichtbar sind. Selbst wenn nur einem einzigen nicht-anonymen Benutzer der Zugriff auf die Informationen zur Mitgliedschaft verweigert wurde, sind die Informationen zur Gruppenmitgliedschaft nicht vollständig öffentlich.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
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.