Copy Method

String.Copy Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Creates a new instance of String with the same value as a specified String.

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

'Declaration
Public Shared Function Copy ( _
	str As String _
) As String

Parameters

str
Type: System.String
The string to copy.

Return Value

Type: System.String
A new string with the same value as str.

ExceptionCondition
ArgumentNullException

str is Nothing.

The following code example displays two disimilar strings referenced by two variables, creates a copy of the first string, assigns a reference to the new string to the second variable, then displays the two strings referenced by the variables to demonstrate that the strings are now identical.


' Sample for String.Copy()

Class Example

   Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
      Dim str1 As String = "abc"
      Dim str2 As String = "xyz"
      outputBlock.Text += String.Format("1) str1 = '{0}'", str1) & vbCrLf
      outputBlock.Text += String.Format("2) str2 = '{0}'", str2) & vbCrLf
      outputBlock.Text &= "Copy..." & vbCrLf
      str2 = [String].Copy(str1)
      outputBlock.Text += String.Format("3) str1 = '{0}'", str1) & vbCrLf
      outputBlock.Text += String.Format("4) str2 = '{0}'", str2) & vbCrLf
   End Sub 'Main
End Class 'Sample
'
'This example produces the following results:
'1) str1 = 'abc'
'2) str2 = 'xyz'
'Copy...
'3) str1 = 'abc'
'4) str2 = 'abc'
'


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2017 Microsoft