Share via


SPFeature.Version - Propriété

Obtient la version actuelle de la fonctionnalité.

Espace de noms :  Microsoft.SharePoint
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Property Version As Version
    Get
    Friend Set
'Utilisation
Dim instance As SPFeature
Dim value As Version

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

Valeur de propriété

Type : System.Version
La version de la fonctionnalité.

Remarques

La valeur de cette propriété peut être différente de la valeur de la propriété Version de la définition de la fonction sous-jacente. Par exemple, vous pouvez déployer une fonctionnalité qui utilise une définition de fonctionnalité avec un numéro de version 1. À ce stade, l'instance de fonction et la définition de fonctionnalité ont le même numéro de version. Supposons que par la suite vous modifiez la définition de la fonction et le redéployez avec un numéro de version 2. La définition de fonctionnalité est désormais une version 2, mais la fonctionnalité reste la version 1. La différence indique que l'instance de fonction doit être mise à niveau. Vous devez exécuter le code de mise à niveau de fonctionnalité pour modifier la version de l'instance de fonction à partir de 1 à 2.

Exemples

L'exemple suivant obtient la collection au niveau de la batterie de serveurs qui contient toutes les instances d'une fonction qui doivent être mis à niveau. Le code parcourt la collection, puis met à jour la fonctionnalité.

//  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

Voir aussi

Référence

SPFeature classe

SPFeature - Membres

Microsoft.SharePoint - Espace de noms

Definition

Version