SPFeature-Klasse
Stellt den Zustand eines Features bei der entsprechende Bereich dar.
Vererbungshierarchie
System.Object
Microsoft.SharePoint.SPFeature
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public NotInheritable Class SPFeature
'Usage
Dim instance As SPFeature
public sealed class SPFeature
Hinweise
Das Vorhandensein eines SPFeature -Objekts in einer Auflistung in der Serverfarm, Webanwendung, Websitesammlung oder Website-Ebene gibt an, dass die Funktion aktiviert ist. Fehlen eines SPFeature -Objekts gibt an, dass das Objekt nicht aktiviert wurde.
Verwenden Sie die Features -Eigenschaft der Klasse SPWebService, SPWebApplication, SPSiteoder SPWeb zum Abrufen der Auflistung von Funktionen, die in der Serverfarm, Web-Anwendung, Websitesammlung oder Website aktiviert werden. Verwenden Sie die SiteFeatures oder WebFeatures -Eigenschaft der SPContext -Klasse zum Abrufen der Auflistung von Funktionen für die aktuelle Websitesammlung oder Website an.
Verwenden Sie Indexer, um ein einzelnes Feature aus der Auflistung zurückzugeben. Verwenden Sie z. B., wenn die Auflistung in eine Variable namens collFeatureszugewiesen wird, collFeatures[index] in C# oder collFeatures(index) in Visual Basic, wobei index die GUID des KE ist.
Beispiele
Im folgenden Codebeispiel wird eine Funktion in der Serverfarm installiert und wird in einer angegebenen Website aktiviert.
Dieses Beispiel erfordert using Richtlinien (Imports in Visual Basic) für die Namespaces Microsoft.SharePoint und Microsoft.SharePoint.Utilities .
System.Globalization.CultureInfo oCultureInfo = new System.Globalization.CultureInfo(1033);
SPFeatureDefinitionCollection collFeatureDefinitions = SPFarm.Local.FeatureDefinitions;
Guid guidFeatureID = new Guid("3C4CD219-D8A7-4fef-BED4-ABA672F7A21A");
SPFeatureDefinition oFeatureDefinition =
collFeatureDefinitions.Add("Feature_Folder\\feature.xml", guidFeatureID);
Response.Write(SPEncode.HtmlEncode(oFeatureDefinition.GetTitle(oCultureInfo)) + " installed.<BR>");
SPFeatureCollection collFeatures = SPContext.Current.Site.AllWebs["Site"].Features;
SPFeature oFeature = collFeatures.Add(guidFeatureID);
Response.Write(SPEncode.HtmlEncode(oFeature.Definition.GetTitle(oCultureInfo)) + " activated.<BR>");
Dim oCultureInfo As New System.Globalization.CultureInfo(1033)
Dim collFeatureDefinitions As SPFeatureDefinitionCollection = SPFarm.Local.FeatureDefinitions
Dim guidFeatureID As New Guid("3C4CD219-D8A7-4fef-BED4-ABA672F7A21A")
Dim oFeatureDefinition As SPFeatureDefinition = collFeatureDefinitions.Add("Feature_Folder\feature.xml", guidFeatureID)
Response.Write(SPEncode.HtmlEncode(oFeatureDefinition.GetTitle(oCultureInfo)) & " installed.<BR>")
Dim collFeatures As SPFeatureCollection = SPContext.Current.Site.AllWebs("Site").Features
Dim oFeature As SPFeature = collFeatures.Add(guidFeatureID)
Response.Write(SPEncode.HtmlEncode(oFeature.Definition.GetTitle(oCultureInfo)) & " activated.<BR>")
Hinweis
Bestimmte Objekte, die IDisposable -Schnittstelle implementieren, und müssen Sie vermeiden, diese Objekte im Arbeitsspeicher beibehalten, nachdem sie nicht mehr benötigt werden. Informationen zu bewährten Programmierpraktiken finden Sie unter Disposing Objects.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.