Windows apps
Collapse the table of content
Expand the table of content
Information
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)

[SecuritySafeCriticalAttribute]
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'
*/


Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

Show:
© 2017 Microsoft