SocialDataService.AddTag Method

Associates a social tag term with the specified URL for the current user.

Namespace:  [SocialDataService Web service]
Web service reference: http://Site/_vti_bin/SocialDataService.asmx

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://microsoft.com/webservices/SharePointPortalServer/SocialDataService/AddTag", RequestNamespace := "https://microsoft.com/webservices/SharePointPortalServer/SocialDataService",  _
    ResponseNamespace := "https://microsoft.com/webservices/SharePointPortalServer/SocialDataService",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function AddTag ( _
    url As String, _
    termID As Guid, _
    title As String, _
    isPrivate As Nullable(Of Boolean) _
) As SocialTagDetail
'Usage
Dim instance As SocialDataService
Dim url As String
Dim termID As Guid
Dim title As String
Dim isPrivate As Nullable(Of Boolean)
Dim returnValue As SocialTagDetail

returnValue = instance.AddTag(url, termID, _
    title, isPrivate)

[SoapDocumentMethodAttribute("https://microsoft.com/webservices/SharePointPortalServer/SocialDataService/AddTag", RequestNamespace = "https://microsoft.com/webservices/SharePointPortalServer/SocialDataService", 
    ResponseNamespace = "https://microsoft.com/webservices/SharePointPortalServer/SocialDataService", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public SocialTagDetail AddTag(
    string url,
    Guid termID,
    string title,
    Nullable<bool> isPrivate
)

Parameters

• url
  Type: System.String

  The URL for which the social tag is added. This value must be in a valid URI format and must contain fewer than 2085 characters.

• termID
  Type: System.Guid

  The identifier (ID) of the social tag term.

• title
  Type: System.String

  The title of the social tag. This value must contain fewer than 501 characters.

• isPrivate
  Type: System.Nullable<Boolean>

  true to indicate the social tag is private; otherwise, false. If this value is null , this method assumes the value of false for this parameter.

Return Value

Type: [SocialDataService Web service].SocialTagDetail
The new social tag.

Exceptions

Exception	Condition
ArgumentNullException	url is null .
UriFormatException	The value of url is not in a valid format.
InvalidOperationException	The social tag term is not available for tagging.

Remarks

This method associates the social comment with the specified URL for the current user.

See Also

Reference

SocialDataService Class

SocialDataService Members

SocialDataService Web Service