Freigeben über


SPFeature.Version-Eigenschaft

Ruft die aktuelle Version des Features.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
Public Property Version As Version
    Get
    Friend Set
'Usage
Dim instance As SPFeature
Dim value As Version

value = instance.Version
public Version Version { get; internal set; }

Eigenschaftswert

Typ: System.Version
Die Version der Funktion.

Hinweise

Der Wert dieser Eigenschaft kann sich vom Wert der Version -Eigenschaft des zugrunde liegenden Featuredefinition. Sie können z. B. eine Funktion bereitstellen, eine Featuredefinition mit einer Versionsnummer 1 verwendet. An diesem Punkt haben die Feature-Instanz und die KE-Definition die gleiche Versionsnummer. Angenommen Sie, anschließend die KE-Definition ändern und erneut mit einer Versionsnummer 2 bereitstellen. Die KE-Definition ist nun Version 2, aber die Funktion Instanz bleibt Version 1. Die Abweichung zeigt an, dass die Feature-Instanz aktualisiert werden muss. Sie müssen Feature Upgrade Code, um die Version der Funktion Instanz von 1 in 2 zu ändern.

Beispiele

Im folgenden Beispiel wird eine farmweite Auflistung, die alle Varianten eines KE, die aktualisiert werden müssen. Der Code durchläuft die Auflistung und aktualisiert die Funktion klicken.

//  Represent the ID of the Feature we want to upgrade.
Guid featureId = new Guid("1B006A62-7B92-475c-A2E5-A1CF03EE0887");

//  Get the default Web service in the farm.
SPWebService webService = SPFarm.Local.Services.GetValue<SPWebService>("");

//  Get all Feature instances with the specified ID that require upgrade.
SPFeatureQueryResultCollection features = webService.QueryFeatures(featureId, true);

//  Get a Features enumerator.
IEnumerator<SPFeature> featureEnumerator = features.GetEnumerator();

while (featureEnumerator.MoveNext())
{
    //  Get current Feature.
    SPFeature feature = featureEnumerator.Current;

    //  Upgrade the current Feature.
    Console.WriteLine("Upgrading Feature {0} with ID {1}.", 
                      feature.Definition.DisplayName, feature.DefinitionId);
    Console.WriteLine("Feature Version Before Upgrade: {0}", feature.Version);
    feature.Upgrade(false);
    Console.WriteLine("Feature Version After Upgrade: {0}", feature.Version);
}
'  Represent the ID of the Feature we want to upgrade.
Dim featureId As New Guid("1B006A62-7B92-475c-A2E5-A1CF03EE0887")

'  Get the default Web service in the farm.
Dim webService As SPWebService = SPFarm.Local.Services.GetValue(Of SPWebService)("")

'  Get all Feature instances with the specified ID that require upgrade.
Dim features As SPFeatureQueryResultCollection = webService.QueryFeatures(featureId, True)

'  Get a Features enumerator.
Dim featureEnumerator As IEnumerator(Of SPFeature) = features.GetEnumerator()

Do While featureEnumerator.MoveNext()
    '  Get current Feature.
    Dim feature As SPFeature = featureEnumerator.Current

    '  Upgrade the current Feature.
    Console.WriteLine("Upgrading Feature {0} with ID {1}.", feature.Definition.DisplayName, feature.DefinitionId)
    Console.WriteLine("Feature Version Before Upgrade: {0}", feature.Version)
    feature.Upgrade(False)
    Console.WriteLine("Feature Version After Upgrade: {0}", feature.Version)
Loop

Siehe auch

Referenz

SPFeature Klasse

SPFeature-Member

Microsoft.SharePoint-Namespace

Definition

Version