Microsoft.Office.Server.Audience-Namespace

Enthält Klassen, die Erstellen von Zielgruppen und Daten an eine bestimmte Benutzergruppe adressieren.

Zusätzlich zu regelbasierte Benutzergruppen können Sie die Ausrichtung basierend auf der SharePoint-Gruppen und Verteilerlisten (DL) implementieren. Sie können auch die Inhalte auf der Ebene von Listenelementen nicht nur auf die Listenebene ausrichten.

Hinweis

Sie können einen Webdienst verwenden, der alle SharePoint-Websites findet, die einem bestimmten Benutzer gerichtet sind. Weitere Informationen finden Sie unter How to: Use the Published Links Web Service.

Beispiel 1: Abrufen der AudienceManager-Objekts in SharePoint Server

Das Objekt AudienceManager ist Objekt der obersten Ebene in der Benutzergruppen-Objektmodells. Sie können ein AudienceManager -Objekt rufen Sie mithilfe der Syntax im folgenden Codebeispiel dargestellt. Ersetzen Sie servername mit einen Istwert und Hinzufügen von Code, die Sie möglicherweise vor der Nutzung in diesem Beispiel wird.

using (SPSite site = new SPSite("https://servername"))
 {
   ServerContext context = ServerContext.GetContext(site);
   AudienceManager audManager = new AudienceManager(context);
   //your code here
 }

Beispiel 2: Personalisierte Portale

Im folgenden Codebeispiel wird veranschaulicht, wie um Listenelementen an eine bestimmte Benutzergruppe zu adressieren.

    AudienceLoader audienceLoader = AudienceLoader.GetAudienceLoader();
   foreach (SPListItem listItem in list.Items)
   {
    // Get roles the list item is targeted to.
     string audienceFieldValue = (string)listItem[k_AudienceColumn];

    // Quickly check if the user belongs to any of those roles.
     if (AudienceManager.IsCurrentUserInAudienceOf(audienceLoader, audienceFieldValue, false))
                {
                    // is a member
                }
                else
                {
                    // not a member
                }
  }

Klassen

	Klasse	Beschreibung
	Audience	Eine Zielgruppe auf einer SharePoint-Website darstellt.
	AudienceAccountNameNotResolvedException	Stellt eine Ausnahme, die ausgelöst wird, wenn der Audience Kontoname ungültig ist.
	AudienceADImportException	Stellt die Ausnahme, die ausgelöst wird, tritt ein Fehler beim Abrufen von Daten aus dem Verzeichnisdienst Microsoft Active Directory.
	AudienceArgumentException	Stellt die Ausnahme wird ausgelöst, wenn ungültige Daten in die AudienceCollection und AudienceSiteCollection -Klassen bereitgestellt werden.
	AudienceCollection	Stellt eine Auflistung von Zielgruppen für eine Portalwebsite.
	AudienceCollection.AudienceEnumerator	Stellt den Enumerator für Audience -Objekte in das AudienceCollection -Objekt.
	AudienceConnectionException	Stellt die Ausnahme wird ausgelöst, wenn ein Fehler auftritt, wenn eine Verbindung zu der Datenbank herstellen.
	AudienceDataValueOutOfRangeException	Stellt eine Ausnahme ausgelöst, wenn ein Wert außerhalb des zulässigen Bereichs ist.
	AudienceDataWrongFormatException	Stellt eine Ausnahme, die ausgelöst wird, wenn die Audience Daten im falschen Format.
	AudienceDuplicateNameException	Stellt die Ausnahme wird ausgelöst, wenn ein Benutzer versucht, erstellen oder Umbenennen einer Benutzergruppe auf einen Namen, der bereits in der Datenbank vorhanden ist.
	AudienceException	Stellt die Basisklasse für Ausnahmen, die Zielgruppe.
	AudienceExecutionException	Stellt die Ausnahme wird ausgelöst, wenn ein Fehler tritt auf, wenn eine Operation Publikum z. B. erstellen, entfernen oder aktualisieren eine Zielgruppe ausführt.
	AudienceGroupOperationException	Stellt eine Ausnahme ausgelöst, wenn ein Fehler während des Vorgangs eine Gruppe im Publikum auftritt.
	AudienceInCompilationException	Löst eine Ausnahme aus, wenn ein Benutzer versucht, das Publikum Daten verändern, während Benutzergruppenregeln kompilieren.
	AudienceJob	Stellt ein Verfahren zum Starten und Beenden der Zielgruppe für vollständige und inkrementelle Kompilierungen
	AudienceLeftContent	Stellt den Inhalt Operand einer Benutzergruppenregel dar.
	AudienceManager	Stellt den Einstiegspunkt für die Zielgruppe Klassen dar.
	AudienceNameDescriptionLengthException	Stellt eine Ausnahme, die ausgelöst wird, wenn die Länge der Namen der Benutzergruppe 50 Zeichen überschreitet oder wenn die Beschreibung länger als 254 Zeichen ist.
	AudienceNameID	Stellt eine Zusammenfassung der Informationen über einen Benutzer, z. B. den Namen und den GUID, und ob das Publikum noch gültig ist.
	AudienceNoContentException	Stellt eine Ausnahme bei einem beim Abrufen von Daten Fehler vom AudienceManager -Objekt ausgelöst.
	AudienceNotExistException	Implementiert die Ausnahme wird ausgelöst, wenn ein Publikum in der Datenbank nicht gefunden werden kann.
	AudienceOperator	Die Definition eines Operators Publikum darstellt.
	AudienceOperatorException	Stellt die Ausnahme wird von der Klasse Audience und AudienceManager , wenn ein Operator für einer Regeldefinition Fehler auftritt.
	AudienceOwnerAccountNameLengthException	Stellt eine Ausnahme ausgelöst, wenn die Länge der Kontoname des Sitebesitzers 400 Zeichen überschreitet.
	AudienceRuleComponent	Stellt eine Regel in einer Zielgruppe.
	AudienceRuleLeftContentException	Stellt die Ausnahme wird ausgelöst, wenn ein im Operanden Teil einer Benutzergruppenregel erstellen Fehler.
	AudienceRuleRightContentException	Stellt die Ausnahme von der AudienceRuleComponent -Klasse ausgelöst, wenn ein in der Regeldefinition in Fehler.
	AudienceSite	Stellt einen Einstiegspunkt für den Zugriff auf die Zielgruppe, die einer Portalwebsite zugeordnet.
	AudienceSiteCollection	Stellt eine Auflistung von Portalwebsites, die eine bestimmte Benutzergruppe zugeordnet sind.
	AudienceSiteCollection.AudienceSiteEnumerator	Listet die Sites in der AudienceSiteCollection -Klasse.
	AudienceSiteInfo	Stellt Informationen für eine bestimmte Instanz der Klasse AudienceSite zusätzlich zum Microsoft.Office.Server.ServerContext -Objekt mit der Portalwebsite verknüpft ist.
	AudienceWrongAccountNameFormatException	Stellt die Ausnahme dar, die ausgelöst wird, wenn die falschen Kontonamenformat in einer Benutzergruppenregel gefunden wird.
	EmptyToolPaneControl	Diese Klasse und ihre Mitglieder sind der internen Verwendung vorbehalten und können nicht in Ihrem Code verwendet werden.
	MembershipInfo	Speichert Informationen aus Microsoft Active Directory-Verzeichnisdienst zu einem Benutzer oder einer Gruppe.
	UserInfo	Benutzerinformationen aus dem Benutzerprofil des Benutzers, wie z. B. e-Mail-Adresse und den Namen darstellt.

Enumerationen

	Enumeration	Beschreibung
	AudienceAccessRights	Stellt die Zugriffsrechte, die auf Zielgruppen aufweisen kann.
	AudienceGroupOperation	Gibt die Arbeitsgänge, die für eine Benutzergruppe ausgeführt werden können, die über mehrere Regeln verfügt.
	AudienceJobReturnCode	Gibt den Status des Methodenaufrufs RunAudienceJob .
	AudienceType	Stellt den Typ der Zielgruppe.