Метод TaxonomyField.GetFieldValue

Статья
03/15/2016

Преобразует заданное строковое значение в объект TaxonomyFieldValueCollection или TaxonomyFieldValue .

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

Синтаксис

'Декларация
Public Overrides Function GetFieldValue ( _
    value As String _
) As Object
'Применение
Dim instance As TaxonomyField
Dim value As String
Dim returnValue As Object

returnValue = instance.GetFieldValue(value)

public override Object GetFieldValue(
    string value
)

Параметры

value
Тип: System.String

Форматированную строку, содержащую сведения идентификатора метки и путь для преобразования в объект TaxonomyFieldValueCollection или TaxonomyFieldValue .

Возвращаемое значение

Тип: System.Object
Объект TaxonomyFieldValue или TaxonomyFieldValueCollection объект, который представляет параметр value .

Замечания

Строка параметра value должен быть отформатирован как один или несколько маркеров строки, разделенные разделителем Delimiter серию. Каждый маркер содержит внутренний идентификатор, метки и путь:[ID;#LABEL|PATH].[ID] — внутренний идентификатор элемента списка.[LABEL] является по умолчанию Label , из соответствующего Term в TermStore.[PATH] является строкой GUID, разделенные символом вертикальной черты (|) и Terminating в GUID, который определяет Term: [ROOT_TERM_GUID|...|PARENT_TERM_GUID|TERM_GUID].

Например [id;#label|path] представляет единичное значение. Строка [id1;#label1|path1;#id2;#label2|path2;#id3;#label3|path3] представляет три значения taxonomyfield, которые могут быть проанализированы в объект TaxonomyFieldValueCollection .

Разделители в строковое представление value определяются следующие свойства:[;#] возвращается свойством Delimiter и [|] возвращается свойством TaxonomyGuidLabelDelimiter .

Свойство AllowMultipleValues определяет, разрешает ли объект TaxonomyField несколько значений. Если объект TaxonomyField не допускает несколько значений, возвращается объект TaxonomyFieldValue . В противном случае объект TaxonomyFieldValueCollectionвозвращается, даже если параметр value представляет единичное значение.