AudienceManager-Klasse

Stellt den Einstiegspunkt für die Zielgruppe Klassen dar.

Vererbungshierarchie

System.Object
  Microsoft.Office.Server.Audience.AudienceManager

Namespace:  Microsoft.Office.Server.Audience
Assembly:  Microsoft.Office.Server.UserProfiles (in Microsoft.Office.Server.UserProfiles.dll)

Syntax

'Declaration
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.Demand, ObjectModel := True)> _
Public Class AudienceManager _
    Implements IRuntimeFilter2, IRuntimeFilter
'Usage
Dim instance As AudienceManager

[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.Demand, ObjectModel = true)]
public class AudienceManager : IRuntimeFilter2, 
    IRuntimeFilter

Hinweise

Die AudienceManager -Klasse ist der Einstiegspunkt für das Publikum Feature in Microsoft SharePoint Server 2010. Es stellt eine Implementierung von IRuntimeFilter, denen Webparts und andere Inhalte für eine bestimmte Zielgruppe ausgerichtet sein können. Die AudienceManager -Klasse unterstützt Laufzeitfunktionen wie z. B. das Abrufen von Zielgruppen-Listen, die der Benutzer angehört. Nach dem Erstellen einer Instanz der AudienceManager -Klasse können Sie abrufen, einzelne Teilnehmer Typen, Listen von Zielgruppen und Listen der Benutzer einer Benutzergruppe zugeordnet sind.

Es gibt verschiedene Standardregeln für Authentifizierung und Bereiche, die für das AudienceManager -Objekt implementiert:

• Mitglieder der Administrator-Websitegruppe für SharePoint Server können anzeigen und ändern die einer Portalwebsite zugeordneten Zielgruppen.

• Mitglieder der Administrator-Websitegruppe können auch Informationen für andere Portalwebsites Publikum anzeigen, mit denen sie Dienste gemeinsam nutzen. Gemeinsame Dienste sind Portaldienste, die serverfarmübergreifend gemeinsam verwendet werden. Die Dienste werden zentral von einem einzelnen Server für zwei oder mehr Serverfarmen verwaltet.

• Mitglieder der Administrator-Websitegruppe der übergeordneten Portalwebsite können auflisten und Anzeigen von Informationen für untergeordnete Portalwebsites Publikum. Diese Informationen sind schreibgeschützt.

• Ein Mitglied der Websitegruppe Leser oder Teilnehmer kann nur eine Liste der Benutzergruppen zugreifen, zu der er gehört. Diese Informationen werden von der überladenen GetUserAudienceIDs -Methode zurückgegeben.

Beispiele

In diesem Codebeispiel wird veranschaulicht, wie eine regelbasiertes Publikum erstellen, die Sie den Inhalt ausrichten können.

Ersetzen Sie servername und andere Zeichenfolgen durch tatsächliche Werte, bevor das Codebeispiel ausgeführt wird. Fügen Sie zudem die folgenden Verweise im Microsoft Visual Studio-Projekt hinzu:

• Microsoft.Office.Server

• Microsoft.SharePoint

• System.Web

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint.Administration;
using Microsoft.Office.Server.Audience;
using Microsoft.SharePoint;
using Microsoft.Office.Server;
using System.Web;

namespace AudienceConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                using (SPSite site = new SPSite("https://servername"))
                {
                    SPServiceContext context = SPServiceContext.GetContext(site);
                    AudienceManager audManager = new AudienceManager(context);

                    AudienceCollection ac = audManager.Audiences;
                    Audience a = null;
                    string sAudName = "Customer Connection";
                    string sDescription = "Members of the Customer Connection v-team";

                    try
                    {
                        a = ac.Create(sAudName, sDescription);
                    }
                    catch (AudienceDuplicateNameException e)
                    {
                        //Your exception handling code here
                    }
                    catch (AudienceException e1)
                    {
                        //Your exception handling code here
                    }
                }

            }
            catch (Exception exception)
            {
                Console.WriteLine(exception.ToString());
                Console.Read();
            }

        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SharePoint.Administration
Imports Microsoft.Office.Server.Audience
Imports Microsoft.SharePoint
Imports Microsoft.Office.Server
Imports System.Web

Namespace AudienceConsoleApp
    Module Program
        Sub Main(ByVal args() As String)
            Try
                Using site As New SPSite("https://servername")
                    Dim context As SPServiceContext = SPServiceContext.GetContext(site)
                    Dim audManager As New AudienceManager(context)

                    Dim ac As AudienceCollection = audManager.Audiences
                    Dim a As Audience = Nothing
                    Dim sAudName As String = "Customer Connection"
                    Dim sDescription As String = "Members of the Customer Connection v-team"

                    Try
                        a = ac.Create(sAudName, sDescription)
                    Catch e As AudienceDuplicateNameException
                        'Your exception handling code here
                    Catch e1 As AudienceException
                        'Your exception handling code here
                    End Try
                End Using

            Catch exception As Exception
                Console.WriteLine(exception.ToString())
                Console.Read()
            End Try

        End Sub
    End Module
End Namespace

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.

Siehe auch

Referenz

AudienceManager-Member

Microsoft.Office.Server.Audience-Namespace