String.Copy Method

July 28, 2014

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

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

public static string Copy(
	string str
)

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 null.

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()
using System;

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      string str1 = "abc";
      string str2 = "xyz";
      outputBlock.Text += String.Format("1) str1 = '{0}'", str1) + "\n";
      outputBlock.Text += String.Format("2) str2 = '{0}'", str2) + "\n";
      outputBlock.Text += "Copy..." + "\n";
      str2 = String.Copy(str1);
      outputBlock.Text += String.Format("3) str1 = '{0}'", str1) + "\n";
      outputBlock.Text += String.Format("4) str2 = '{0}'", str2) + "\n";
   }
}
/*
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:
© 2014 Microsoft