Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Converts the specified string value into a TaxonomyFieldValue or a TaxonomyFieldValueCollection object.
Namespace: Microsoft.SharePoint.Taxonomy
Assembly: Microsoft.SharePoint.Taxonomy (in Microsoft.SharePoint.Taxonomy.dll)
Syntax
'Declaration
Public Overrides Function GetFieldValue ( _
value As String _
) As Object
'Usage
Dim instance As TaxonomyField
Dim value As String
Dim returnValue As Object
returnValue = instance.GetFieldValue(value)
public override Object GetFieldValue(
string value
)
Parameters
value
Type: System.StringA formatted string containing identifier, label, and path information to convert into aTaxonomyFieldValue or aaa TaxonomyFieldValueCollection object.
Return Value
Type: System.Object
A TaxonomyFieldValue object or a TaxonomyFieldValueCollection object that represents the value parameter.
Remarks
The value parameter string must be formatted as a series of one or more string tokens separated by the Delimiter delimiter. Each token consists of an internal identifier, a label, and a path:[ID;#LABEL|PATH].[ID] is the internal identifier of the list item.[LABEL] is the default Label of the corresponding Term in the TermStore.[PATH] is a string of GUIDs delimited by a pipe (|) character and Terminating in the GUID that identifies the Term: [ROOT_TERM_GUID|...|PARENT_TERM_GUID|TERM_GUID].
For example, [id;#label|path] represents a single value. The string [id1;#label1|path1;#id2;#label2|path2;#id3;#label3|path3] represents three taxonomyfield values that can be parsed into a TaxonomyFieldValueCollection object.
The delimiters in the value string representation are defined by the following properties:[;#] is returned by the Delimiter property, and [|] is returned by the TaxonomyGuidLabelDelimiter property.
The AllowMultipleValues property deTermines whether the TaxonomyField object allows multiple values. If the TaxonomyField object does not allow multiple values, a TaxonomyFieldValue object is returned. Otherwise a TaxonomyFieldValueCollectionobject is returned even if the value parameter represents a single value.