Article
11/18/2011

UriBuilder.Fragment Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets the fragment portion of the URI.

Namespace: System
Assembly: System (in System.dll)

Syntax

'Declaration
Public Property Fragment As String

public string Fragment { get; set; }

Property Value

Type: System.String
The fragment portion of the URI. The fragment identifier ("#") is added to the beginning of the fragment.

Remarks

The Fragment property contains any text following a fragment marker (#) in the URI, including the marker itself. When setting the Fragment property, the fragment marker is added to its value. Note In version 1.0 and 1.1 of the .NET Framework, setting the Fragment property to any value, including nulla null reference (Nothing in Visual Basic), cleared the Query property, and setting the Fragment property to nulla null reference (Nothing in Visual Basic) or to String.Empty cleared the property. In version 2.0, however, the Fragment and Query properties are independent.

Note Do not append a string directly to this property. If the length of Fragment is greater than 1, retrieve the property value as a string, remove the leading pound sign, append the new query string, and set the property with the combined string.

Examples

The following example creates the URI "https://www.contoso.com/index.htm#main".

  Dim uBuild As New UriBuilder("https://www.contoso.com/")
  uBuild.Path = "index.htm"
  uBuild.Fragment = "main"

  Dim myUri As Uri = uBuild.Uri

   UriBuilder uBuild = new UriBuilder("https://www.contoso.com/");
   uBuild.Path = "index.htm";
   uBuild.Fragment = "main";

   Uri myUri = uBuild.Uri;

   outputBlock.Text += "Uri: ";
   outputBlock.Text += myUri.ToString();
   outputBlock.Text += "\n";

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Partager via