Audience - Classe

Représente une audience sur un site SharePoint.

Hiérarchie d’héritage

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

Espace de noms :  Microsoft.Office.Server.Audience
Assembly :  Microsoft.Office.Server.UserProfiles (dans Microsoft.Office.Server.UserProfiles.dll)

Syntaxe

'Déclaration
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public Class Audience
'Utilisation
Dim instance As Audience

[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public class Audience

Remarques

Les audiences sont des groupes d'utilisateurs déterminées par leur appartenance à des listes de distribution Microsoft Exchange (DL) ou des groupes SharePoint, ou les règles configurées par un administrateur du portail. Par exemple, vous pouvez définir des nouveaux employés, cadres, commerciaux ou des personnes à partir d'une ville spécifiée en tant que les audiences. Les règles d'audience peuvent être basés sur les informations contenues dans le profil utilisateur, son appartenance à un groupe de sécurité Active Directory directory service ou une liste de distribution Exchange, ou sur la structure de création de rapports de l'organisation (si ces informations sont conservées dans Active Directory).

Les audiences permettent aux organisations de cibler du contenu à l'intention des utilisateurs selon leur fonction ou leurs tâches, comme défini par leur appartenance à un groupe SharePoint ou une liste de distribution, par la structure de rapports de l'organisation ou par les propriétés publiques contenues dans leur profil utilisateur.

Vous pouvez cibler en fonction d'audience, les groupes SharePoint et les appartenances DL. En outre, vous pouvez cibler le niveau de l'élément de liste, plutôt que simplement au niveau de la liste.

Exemples

Cet exemple de code montre comment créer une audience basée sur des règles, pour laquelle vous pouvez cibler du contenu.

Avant d'exécuter l'exemple de code, remplacez servername et autres chaînes avec des valeurs réelles. Ajoutez également les références suivantes dans votre projet Visual Studio :

• 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"))
                {
                    ServerContext context = ServerContext.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)
                    {
                        //Add your exception handling code here.
                    }
                    catch (AudienceException e1)
                    {
                        //Add 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 ServerContext = ServerContext.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
                        'Add your exception handling code here.
                    Catch e1 As AudienceException
                        'Add 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

Cohérence de thread

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.

Voir aussi

Référence

Audience - Membres

Microsoft.Office.Server.Audience - Espace de noms