Creates a new instance of
String with the same value as a specified
String.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Visual Basic (Declaration)
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 String^ Copy (
String^ str
)
public static String Copy (
String str
)
public static function Copy (
str : String
) : String
Parameters
- str
The String to copy.
Return Value
A new String with the same value as str.
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)
Console.WriteLine("Copy...")
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'
'Copy...
'3) str1 = 'abc'
'4) str2 = 'abc'
'
// Sample for String.Copy()
using System;
class Sample {
public static void Main() {
string str1 = "abc";
string str2 = "xyz";
Console.WriteLine("1) str1 = '{0}'", str1);
Console.WriteLine("2) str2 = '{0}'", str2);
Console.WriteLine("Copy...");
str2 = String.Copy(str1);
Console.WriteLine("3) str1 = '{0}'", str1);
Console.WriteLine("4) str2 = '{0}'", str2);
}
}
/*
This example produces the following results:
1) str1 = 'abc'
2) str2 = 'xyz'
Copy...
3) str1 = 'abc'
4) str2 = 'abc'
*/
// Sample for String::Copy()
using namespace System;
int main()
{
String^ str1 = "abc";
String^ str2 = "xyz";
Console::WriteLine( "1) str1 = '{0}'", str1 );
Console::WriteLine( "2) str2 = '{0}'", str2 );
Console::WriteLine( "Copy..." );
str2 = String::Copy( str1 );
Console::WriteLine( "3) str1 = '{0}'", str1 );
Console::WriteLine( "4) str2 = '{0}'", str2 );
}
/*
This example produces the following results:
1) str1 = 'abc'
2) str2 = 'xyz'
Copy...
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);
Console.WriteLine("Copy...");
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'
Copy...
3) str1 = 'abc'
4) str2 = 'abc'
*/
Windows 98, Windows 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
.NET Framework
Supported in: 2.0, 1.1, 1.0
.NET Compact Framework
Supported in: 2.0, 1.0