.NET Framework Class Library
WebBrowser..::.NavigateToString Method

Updated: July 2008

Navigate asynchronously to a String that contains the content for a document.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)
Syntax

Visual Basic (Declaration)
Public Sub NavigateToString ( _
    text As String _
)
Visual Basic (Usage)
Dim instance As WebBrowser
Dim text As String

instance.NavigateToString(text)
C#
public void NavigateToString(
    string text
)
Visual C++
public:
void NavigateToString(
    String^ text
)
JScript
public function NavigateToString(
    text : String
)
XAML
You cannot use methods in XAML.

Parameters

text
Type: System..::.String
The String that contains the content for a document.
Exceptions

ExceptionCondition
ObjectDisposedException

The WebBrowser instance is no longer valid.

InvalidOperationException

A reference to the underlying native WebBrowser could not be retrieved.

Remarks

If the text parameter is nullNothingnullptra null reference (Nothing in Visual Basic), WebBrowser navigates to a blank document ("about:blank").

If the text parameter is not in valid HTML format, it will be displayed as plain text.

After navigation, Source will be nullNothingnullptra null reference (Nothing in Visual Basic).

Examples

The following example shows how to navigate to a string that contains a document.

C#
private void goNavigateToStringButton_Click(object sender, RoutedEventArgs e)
{
  // Load HTML document as a string
  Uri uri = new Uri(@"pack://application:,,,/HTMLDocumentWithoutScript.html", UriKind.Absolute);
  Stream stream = Application.GetResourceStream(uri).Stream;
  using (StreamReader reader = new StreamReader(stream))
  {
    // Navigate to HTML document string
    this.webBrowser.NavigateToString(reader.ReadToEnd());
  }
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5 SP1, 3.0 SP2
See Also

Reference

Other Resources

Change History

Date

History

Reason

July 2008

Added topic for new class.

SP1 feature change.

Tags :


Page view tracker