Windows desktop applications
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

String.Copy Method

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

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

Public Shared Function Copy ( _
	str As String _
) As String
Dim str As String
Dim returnValue As String

returnValue = String.Copy(str)
public static String Copy (
	String str
public static function Copy (
	str : String
) : String
Not applicable.



The String to copy.

Return Value

A new String with the same value as str.

Exception typeCondition


str is a null reference (Nothing in Visual Basic).

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()
Imports System

Class Sample
   Public Shared Sub Main()
      Dim str1 As String = "abc"
      Dim str2 As String = "xyz"
      Console.WriteLine("1) str1 = '{0}'", str1)
      Console.WriteLine("2) str2 = '{0}'", str2)
      str2 = [String].Copy(str1)
      Console.WriteLine("3) str1 = '{0}'", str1)
      Console.WriteLine("4) str2 = '{0}'", str2)
   End Sub 'Main
End Class 'Sample
'This example produces the following results:
'1) str1 = 'abc'
'2) str2 = 'xyz'
'3) str1 = 'abc'
'4) str2 = 'abc'

// Sample for String.Copy()
import System.*;

class Sample
    public static void main(String[] args)
        String str1 = "abc";
        String str2 = "xyz";
        Console.WriteLine("1) str1 = '{0}'", str1);
        Console.WriteLine("2) str2 = '{0}'", str2);
        str2 = String.Copy(str1);
        Console.WriteLine("3) str1 = '{0}'", str1);
        Console.WriteLine("4) str2 = '{0}'", str2);
    } //main
} //Sample
This example produces the following results:
1) str1 = 'abc'
2) str2 = 'xyz'
3) str1 = 'abc'
4) str2 = 'abc'

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions

© 2016 Microsoft