String.Copy(String) Metod

public:
 static System::String ^ Copy(System::String ^ str);

[System.Obsolete("This API should not be used to create mutable strings. See https://go.microsoft.com/fwlink/?linkid=2084035 for alternatives.")]
public static string Copy(string str);

public static string Copy(string str);

[<System.Obsolete("This API should not be used to create mutable strings. See https://go.microsoft.com/fwlink/?linkid=2084035 for alternatives.")>]
static member Copy : string -> string

static member Copy : string -> string

Public Shared Function Copy (str As String) As String

Parametrar

Returer

En ny sträng med samma värde som str.

Attribut

ObsoleteAttribute

Undantag

Kommentarer

Metoden Copy returnerar ett String objekt som har samma värde som den ursprungliga strängen men representerar en annan objektreferens. Den skiljer sig från en tilldelningsåtgärd som tilldelar en befintlig strängreferens till en ytterligare objektvariabel.

Beroende på varför du vill anropa Copy metoden finns det ett antal alternativ:

• Om du vill att en annan stränginstans ska användas i en åtgärd som ändrar strängen använder du den ursprungliga stränginstansen. Eftersom strängar är oföränderliga skapar strängåtgärden en ny stränginstans och den ursprungliga strängen förblir opåverkad. I det här fallet bör du inte tilldela den nya strängreferensen till den ursprungliga strängvariabeln. I följande exempel visas en bild.

  var original = "This is a sentence. This is a second sentence.";
  var sentence1 = original.Substring(0, original.IndexOf(".") + 1);
  Console.WriteLine(original);
  Console.WriteLine(sentence1);
  // The example displays the following output:
  //    This is a sentence. This is a second sentence.
  //    This is a sentence.
  

  let original = "This is a sentence. This is a second sentence."
  let sentence1 = original.Substring(0, original.IndexOf "." + 1)
  printfn $"{original}"
  printfn $"{sentence1}"
  // The example displays the following output:
  //    This is a sentence. This is a second sentence.
  //    This is a sentence.
  

  Dim original = "This is a sentence. This is a second sentence."
  Dim sentence1 = original.Substring(0, original.IndexOf(".") + 1)
  Console.WriteLine(original)
  Console.WriteLine(sentence1)
  ' The example displays the following output:
  '    This is a sentence. This is a second sentence.
  '    This is a sentence.
  

  I det här fallet skapar en ny stränginstans genom att anropa Copy metoden för att skapa en ny sträng innan metoden anropas Substring i onödan.

• Om du vill skapa en föränderlig buffert med samma innehåll som den ursprungliga strängen String.ToCharArray anropar du konstruktorn eller StringBuilder.StringBuilder(String) . Ett exempel:

  private static void UseMutableBuffer()
  {
      var original = "This is a sentence. This is a second sentence.";
      var chars = original.ToCharArray();
      var span = new Span<char>(chars);
      var slice = span.Slice(span.IndexOf('.'), 3);
      slice = MergeSentence(slice);
      Console.WriteLine($"Original string: {original}");
      Console.WriteLine($"Modified string: {span.ToString()}");
  
      static Span<char> MergeSentence(Span<char> span)
      {
          if (span.Length == 0) return Span<char>.Empty;
  
          span[0] = ';';
          span[2] = Char.ToLower(span[2]);
          return span;
      }
  }
  // The example displays the following output:
  //    Original string: This is a sentence. This is a second sentence.
  //    Modified string: This is a sentence; this is a second sentence.
  

  let mergeSentence (span: Span<char>) =
      if span.Length = 0 then
          Span<char>.Empty
      else
          span[0] <- '\000'
          span[2] <- Char.ToLower span[2]
          span
  
  let useMutableBuffer () =
      let original = "This is a sentence. This is a second sentence."
      let chars = original.ToCharArray()
      let span = Span chars
      let slice = span.Slice(span.IndexOf '.', 3)
      let slice = mergeSentence slice
      let span = span.ToString()
      printfn $"Original string: {original}"
      printfn $"Modified string: {span}"
  // The example displays the following output:
  //    Original string: This is a sentence. This is a second sentence.
  //    Modified string: This is a sentence this is a second sentence.
  

  Private Sub UseMutableBuffer()
      Dim original = "This is a sentence. This is a second sentence."
      Dim sb = new StringBuilder(original)
      Dim index = original.IndexOf(".")
      sb(index) = ";"
      sb(index + 2) = Char.ToLower(sb(index + 2))
      Console.WriteLine($"Original string: {original}")
      Console.WriteLine($"Modified string: {sb.ToString()}")
  End Sub
  ' The example displays the following output:
  '    Original string: This is a sentence. This is a second sentence.
  '    Modified string: This is a sentence; this is a second sentence.
  

• Om du vill skapa en föränderlig kopia av strängen så att du kan använda osäker kod för att ändra stränginnehållet använder du Marshal.StringToHGlobalUni metoden. I följande exempel används Marshal.StringToHGlobalUni metoden för att hämta en pekare till platsen för en kopierad sträng i ohanterat minne, ökar Unicode-kodpunkten för varje tecken i strängen med en och kopierar den resulterande strängen tillbaka till en hanterad sträng.

  private static void UseUnmanaged()
  {
      var original = "This is a single sentence.";
      var len = original.Length; 
      var ptr = Marshal.StringToHGlobalUni(original);
      string? result;
      unsafe 
      {
          char *ch = (char *) ptr.ToPointer();
          while (len-- > 0)
          {
              char c = Convert.ToChar(Convert.ToUInt16(*ch) + 1);
              *ch++ = c;
          } 
          result = Marshal.PtrToStringUni(ptr);
          Marshal.FreeHGlobal(ptr);
      }
      Console.WriteLine($"Original string: {original}");
      Console.WriteLine($"String from interop: '{result}'");
  }
  // The example displays the following output:
  //    Original string: This is a single sentence.
  //    String from interop: 'Uijt!jt!b!tjohmf!tfoufodf/'
  

  #nowarn "9"
  open FSharp.NativeInterop
  
  let useUnmanaged () =
      let original = "This is a single sentence."
      let mutable len = original.Length 
      let ptr = Marshal.StringToHGlobalUni original
      let mutable ch = ptr.ToPointer() |> NativePtr.ofVoidPtr<char> 
      while len > 0 do
          len <- len - 1
          Convert.ToUInt16(NativePtr.read ch) + 1us
          |> Convert.ToChar
          |> NativePtr.write (NativePtr.add ch 1)
          ch <- NativePtr.add ch 1
  
      let result = Marshal.PtrToStringUni ptr
      Marshal.FreeHGlobal ptr
      printfn $"Original string: {original}"
      printfn $"String from interop: '{result}'"
  
  // The example displays the following output:
  //    Original string: This is a single sentence.
  //    String from interop: 'Uijt!jt!b!tjohmf!tfoufodf/'