WebPart.ReplaceTokens Method

Performs token replacement for a string, using the same algorithm used for URL-valued properties.

Namespace:  Microsoft.SharePoint.WebPartPages
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Available in Sandboxed Solutions: No

Syntax

'Declaration
Protected Friend Function ReplaceTokens ( _
    input As String _
) As String
'Usage
Dim input As String
Dim returnValue As String

returnValue = Me.ReplaceTokens(input)
protected internal string ReplaceTokens(
    string input
)

Parameters

  • input
    Type: System.String

    A string that requires token replacement.

Return Value

Type: System.String
The input string with token values replaced.

Remarks

The Web Part architecture provides token replacement for Web Part base class properties that are defined as URLs, which include the HelpLink, DetailLink, PartImageLarge, and PartImageSmall properties. When a Web Part is rendered, values of these properties are scanned for the tokens listed in the following table, and those tokens are replaced with the values described in the following table. The Web Part property value itself is not changed.

Token

Replacement value

_WPR_

ClassResourcePath property

_WPQ_

Qualifier property

_LogonUser_

Request.ServerVariables( "LOGON_USER" )

_WPID_

ID property (Control.ID)

_WebLocaleId_

The LCID of the Web site

_WPSRR_

ServerRelativeClassResourcePath property

Examples

The following code example returns the value of the ClassResourcePath property by replacing the _WPR_ token. To view a more extensive example that passes HTML and ECMAScript (Microsoft JScript or JavaScript) that contains _WPQ_ tokens to the ReplaceTokens method before rendering the controls and script for a Web Part, see the client-side example provided for the ICellProvider interface.

output.Write(ReplaceTokens("Class Resource Path: _WPR_"))
output.Write(ReplaceTokens("Class Resource Path: _WPR_"));

See Also

Reference

WebPart Class

WebPart Members

Microsoft.SharePoint.WebPartPages Namespace