Freigeben über


ExemptUserAgentCollection-Klasse

Eine Auflistung von Benutzer-Agents, die InfoPath-Dateien von InfoPath Forms Services anstelle von Webseiten empfangen kann.

Vererbungshierarchie

System.Object
  Microsoft.SharePoint.Administration.SPPersistedObjectCollection<ExemptUserAgent>
    Microsoft.SharePoint.Administration.SPPersistedChildCollection<ExemptUserAgent>
      Microsoft.Office.InfoPath.Server.Administration.ExemptUserAgentCollection

Namespace:  Microsoft.Office.InfoPath.Server.Administration
Assembly:  Microsoft.Office.InfoPath.Server (in Microsoft.Office.InfoPath.Server.dll)

Syntax

'Declaration
<GuidAttribute("ad1e686e-bc12-42a6-a5be-1eac32eed98b")> _
Public NotInheritable Class ExemptUserAgentCollection _
    Inherits SPPersistedChildCollection(Of ExemptUserAgent) _
    Implements IBackupRestoreConfiguration, IBackupRestore
'Usage
Dim instance As ExemptUserAgentCollection
[GuidAttribute("ad1e686e-bc12-42a6-a5be-1eac32eed98b")]
public sealed class ExemptUserAgentCollection : SPPersistedChildCollection<ExemptUserAgent>, 
    IBackupRestoreConfiguration, IBackupRestore

Hinweise

Diese Auflistung stellt Suche Bots, die indiziert werden können oder andere Agents, die InfoPath-Dateien gespeichert, die auf eine Website zugreifen können. Die Standard- ExemptUserAgentCollection umfasst:

  • Crawler

  • googlebot

  • MS search

  • MSNBot

  • Msoffice

  • slurp

Diese Benutzer-Agents stellen Suche Bots, die häufig in einer Unternehmensumgebung verwendet werden. Wenn eine andere Suchtechnologie verwendet wird und von InfoPath-Dateien nicht indiziert wird werden, sollte der Benutzer-Agent für diese Technologie mit der Add -Methode dieser Auflistung hinzugefügt. Im InfoPath-Client ist nicht in der Auflistung vorhanden, da die Erkennungslogik Client nicht ausschließlich auf den Benutzer-Agenteninformationen in der HTTP-Anforderung entdeckt abhängig ist.

Weitere Informationen über Benutzer-Agents für den Begriff "User-Agent" im Internet zu suchen.

Hinweis

Das Befehlszeilen-Dienstprogramm SharePoint Foundation , stsadm.exe kann auch zum Hinzufügen oder Entfernen von Benutzer-Agents aus der Auflistung verwendet werden. Die Befehlszeilensyntax lautet stsadm –o addexemptuseragent –name und stsadm –o removeexemptuseragent –name, wobei name der Name des Agents ist.

Beispiele

Im folgenden Beispiel schreibt die Nummer der ExemptUserAgent Objekte und führt sie aus der Auflistung. Verweise sind in der Visual Studio-Projekt auf die Microsoft.Office.Server, Microsoft.Office.InfoPath.Serverund Microsoft.SharePoint -Assemblys erforderlich.

Hinweis

Suchen Sie nach der Assembly Microsoft.Office.InfoPath.Server<drive>:\Program Files\Microsoft Office Servers\14.0\Bin. Microsoft.Office.Server -Verweis wird als Komponente von Microsoft Office Server und der Verweis Microsoft.SharePoint als Windows SharePoint Services auf der Registerkarte .NET des Dialogfelds Verweis hinzufügen aufgeführt wird.

Die folgenden import -Anweisungen sind erforderlich für die

Microsoft.Office.Server, Microsoft.Office.InfoPath.Server.Administrationund Microsoft.SharePoint.Administration -Namespace:

    Dim LocalFormsService As FormsService
    Dim LocalFarm As SPFarm
    Dim ExUserAgents As Integer
    Dim ExUserAgent As ExemptUserAgent
    Dim ExUserAgentsCollection As ExemptUserAgentCollection

    Try
        LocalFarm = SPFarm.Local
        LocalFormsService = LocalFarm.Services.GetValue(Of FormsService)(FormsService.ServiceName)
        ExUserAgents = LocalFormsService.ExemptUserAgents.Count()
        Console.WriteLine("Number of exempt user agents: " & ExUserAgents.ToString())
        ExUserAgentsCollection = LocalFormsService.ExemptUserAgents
        For Each ExUserAgent In ExUserAgentsCollection
            Console.WriteLine(ExUserAgent.Name)
        Next
        Console.Write("Press Enter to Continue")
        Console.ReadLine()
    Catch ex As Exception
        Console.WriteLine("Error: " + ex.Message)
        Console.Write("Press Enter to Continue")
        Console.ReadLine()
    End Try

Die folgenden Anweisungen using sind für die Microsoft.Office.Server, Microsoft.Office.InfoPath.Server.Administrationund Microsoft.SharePoint.Administration -Namespaces erforderlich.

    FormsService localFormsService;
    SPFarm localFarm = SPFarm.Local;
    Int16 exAgents;
    ExemptUserAgentCollection exUserAgentCollection;

    try
    {
        localFormsService = localFarm.Services.GetValue<FormsService>(FormsService.ServiceName);
        exAgents = (Int16)localFormsService.ExemptUserAgents.Count;
        Console.WriteLine("Number of exempt user agents: " + exAgents.ToString());
        exUserAgentCollection = localFormsService.ExemptUserAgents;
        foreach(ExemptUserAgent exUserAgent in exUserAgentCollection)
        {
            Console.WriteLine(exUserAgent.Name);
        }
        Console.Write("Press Enter to Continue");
        Console.ReadLine();
    }
    catch (Exception ex)
    {
        Console.WriteLine("Error: " + ex.Message);
        Console.Write("Press Enter to Continue");
        Console.ReadLine();
    }

Threadsicherheit

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

Siehe auch

Referenz

ExemptUserAgentCollection-Member

Microsoft.Office.InfoPath.Server.Administration-Namespace