Compartir a través de


de la propiedad SPFeature.Version

Obtiene la versión actual de la característica.

Espacio de nombres:  Microsoft.SharePoint
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
Public Property Version As Version
    Get
    Friend Set
'Uso
Dim instance As SPFeature
Dim value As Version

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

Valor de propiedad

Tipo: System.Version
La versión de la característica.

Comentarios

El valor de esta propiedad puede ser diferente del valor de la propiedad Version de la definición de característica subyacente. Por ejemplo, puede implementar una característica que usa una definición de característica con un número de versión de 1. En ese momento, la instancia de la función y la definición de característica tienen el mismo número de versión. Suponga que posteriormente se modifique la definición de característica y volver a implementarlo con un número de versión de 2. Ahora la definición de característica es la versión 3, pero la instancia de la característica permanece versión 1. La discrepancia indica que la instancia de característica debe actualizarse. Se debe ejecutar código de actualización de característica para cambiar la versión de la instancia de la característica de 1 a 2.

Ejemplos

En el siguiente ejemplo se obtiene una colección de toda la granja de servidores que contiene todas las instancias de una característica que necesitan actualizarse. A continuación, el código recorre en iteración la colección y actualiza la característica.

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

Vea también

Referencia

clase SPFeature

Miembros SPFeature

Espacio de nombres Microsoft.SharePoint

Definition

Version