String.Copy(String) Método

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

Parâmetros

Devoluções

Uma nova cadeia com o mesmo valor que str.

Atributos

ObsoleteAttribute

Exceções

Observações

O Copy método devolve um String objeto que tem o mesmo valor da cadeia original, mas representa uma referência de objeto diferente. Difere de uma operação de atribuição, que atribui uma referência de string existente a uma variável objeto adicional.

Dependendo do motivo pelo qual pretende chamar o Copy método, existem várias alternativas:

• Se quiseres uma instância de cadeia diferente para usar numa operação que modifique a cadeia, usa a instância original da cadeia. Como as strings são imutáveis, a operação string cria uma nova instância de string, e a string original permanece inalterada. Neste caso, não deve atribuir a nova referência da cadeia à variável original da cadeia. O exemplo a seguir fornece uma ilustração.

  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.
  

  Neste caso, chamar o Copy método para criar uma nova cadeia antes de chamar o Substring método cria desnecessariamente uma nova instância de cadeia.

• Se quiseres criar um buffer mutável com o mesmo conteúdo da cadeia original, chama o String.ToCharArray constructor or StringBuilder.StringBuilder(String) . Por exemplo:

  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.
  

• Se quiseres criar uma cópia mutável da cadeia para poderes usar código inseguro para modificar o conteúdo da cadeia, usa Marshal.StringToHGlobalUni o método. O exemplo seguinte utiliza o Marshal.StringToHGlobalUni método para obter um ponteiro para a localização de uma cadeia copiada na memória não gerida, incrementa o ponto de código Unicode de cada carácter da cadeia em um e copia a cadeia resultante de volta para uma cadeia gerida.

  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/'