Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

String.ToString Method

Returns this instance of String; no actual conversion is performed.

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

Public Overrides Function ToString As String

Return Value

Type: System.String
The current string.

Because this method simply returns the current string unchanged, there is no need to call it directly. It is usually called implicitly in a composite formatting operation, as the example shows.

The following example demonstrates the ToString method. Note that the example does not explicitly call the ToString method. Instead, the method is called implicitly by the composite formatting feature.

Imports System

Class stringToString

   Public Shared Sub Main()
      Dim str1 As [String] = "123" 
      Dim str2 As [String] = "abc"

      Console.WriteLine("Original str1: {0}", str1)
      Console.WriteLine("Original str2: {0}", str2)
      Console.WriteLine("str1 same as str2?: {0}", [Object].ReferenceEquals(str1, str2))

      str2 = str1.ToString()
      Console.WriteLine("New str2:      {0}", str2)
      Console.WriteLine("str1 same as str2?: {0}", [Object].ReferenceEquals(str1, str2))
   End Sub 'Main
End Class 'Sample

'This code produces the following output: 
'Original str1: 123 
'Original str2: abc 
'str1 same as str2?: False 

'New str2:      123 
'str1 same as str2?: True 

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Portable Class Library

Supported in: Portable Class Library
© 2015 Microsoft