Свойство SPFeature.Version

Статья
05/13/2015

Получает текущую версию компонента.

Пространство имен: Microsoft.SharePoint
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Property Version As Version
    Get
    Friend Set
'Применение
Dim instance As SPFeature
Dim value As Version

value = instance.Version

public Version Version { get; internal set; }

Значение свойства

Тип: System.Version
Версия компонента.

Замечания

Значение этого свойства может отличаться от значения свойства Version базового определения функции. Например можно развернуть компонент, использующий Определение компонента с номером версии 1. В этот момент экземпляра функции и определение функции имеют один и тот же номер версии. Предположим, что впоследствии изменить определение компонента и повторно развертывать его номер версии 2. Теперь Определение компонента — версии 2, но экземпляр компонента остается версии 1. Расхождение указывает экземпляр компонента необходимо обновить. Необходимо запустить средство обновления кода изменить версию экземпляра компонента с 1 на 2.

Примеры

Следующий пример получает коллекцию уровня фермы, которая содержит все экземпляры компонента, необходимо обновить. Затем выполняется итерация по коллекции и обновляет функцию.

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

См. также

Справочные материалы

SPFeature класс

Элементы SPFeature

Пространство имен Microsoft.SharePoint

Definition

Version

Поделиться через