SecureString Oluşturucular

Tanım

Ad Alanı:

System.Security

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

SecureString sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

SecureString()	SecureString sınıfının yeni bir örneğini başlatır.
SecureString(Char*, Int32)	Nesnelerin alt dizisinden sınıfının yeni bir örneğini SecureStringChar başlatır. Bu oluşturucu CLS uyumlu değildir. CLS uyumlu alternatifi şeklindedir SecureString().

SecureString()

Kaynak:

SecureString.cs

SecureString sınıfının yeni bir örneğini başlatır.

public:
 SecureString();

public SecureString ();

Public Sub New ()

Özel durumlar

CryptographicException

Bu örneğin değeri korunurken veya korumasını kaldırılırken bir hata oluştu.

NotSupportedException

Bu işlem bu platformda desteklenmiyor.

Örnekler

Aşağıdaki örnek, yeni SecureString bir nesne örneği oluşturmak için varsayılan (veya parametresiz) oluşturucuyu kullanır. Daha sonra yöntemine AppendChar bir karakter dizisi eklemek için yöntemini çağırır.

using namespace System;
using namespace System::Security;

int main(array<System::String ^> ^args)
{
   // Define the string value to assign to a new secure string.
   Char chars[4] = { 't', 'e', 's', 't' };
   // Instantiate the secure string.
   SecureString^ testString = gcnew SecureString();
   // Assign the character array to the secure string.
   for each (Char ch in chars)
   {
      testString->AppendChar(ch);
   }   
   // Display secure string length.
   Console::WriteLine("The length of the string is {0} characters.", 
                        testString->Length);

   delete testString;
   return 0;
}
// The example displays the following output:
//      The length of the string is 4 characters.

using System;
using System.Security;

public class Example
{
   public static void Main()
   {
      // Define the string value to assign to a new secure string.
      char[] chars = { 't', 'e', 's', 't' };
      // Instantiate the secure string.
      SecureString testString = new SecureString();
      // Assign the character array to the secure string.
      foreach (char ch in chars)
         testString.AppendChar(ch);      
      // Display secure string length.
      Console.WriteLine("The length of the string is {0} characters.", 
                        testString.Length);
      testString.Dispose();
   }
}
// The example displays the following output:
//      The length of the string is 4 characters.

Imports System.Security

Module Example
   Public Sub Main()
      ' Define the string value to assign to a new secure string.
      Dim chars() As Char = { "t"c, "e"c, "s"c, "t"c }
      ' Instantiate the secure string.
      Dim testString As SecureString = New SecureString()
      ' Assign the character array to the secure string.
      For Each ch As char In chars
         testString.AppendChar(ch)
      Next         
      ' Display secure string length.
      Console.WriteLine("The length of the string is {0} characters.", _ 
                        testString.Length)
      testString.Dispose()
   End Sub
End Module
' The example displays the following output:
'      The length of the string is 4 characters.

Aşağıdaki örnek, bir SecureString nesnenin değerinden bir String nesne oluşturur.

using namespace System;
using namespace System::Security;

int main(array<System::String ^> ^args)
{
   // Define the string value to be assigned to the secure string.
   String^ initString = "TestString";
   // Instantiate the secure string.
   SecureString^ testString = gcnew SecureString();
   // Assign the character array to the secure string.
   for each (Char ch in initString)
   {
      testString->AppendChar(ch);
   }   
   // Display secure string length.
   Console::WriteLine("The length of the string is {0} characters.", 
                        testString->Length);

   delete testString;
   return 0;
}
// The example displays the following output:
//      The length of the string is 10 characters.

using System;
using System.Security;

public class Example
{
   public static void Main()
   {
      // Define the string value to be assigned to the secure string.
      string initString = "TestString";
      // Instantiate the secure string.
      SecureString testString = new SecureString();
      // Use the AppendChar method to add each char value to the secure string.
      foreach (char ch in initString)
         testString.AppendChar(ch);
         
      // Display secure string length.
      Console.WriteLine("The length of the string is {0} characters.", 
                        testString.Length);
      testString.Dispose();
   }
}
// The example displays the following output:
//      The length of the string is 10 characters.

Imports System.Security

Module Example
   Public Sub Main()
      ' Define the string value to be assigned to the secure string.
      Dim initString As String = "TestString"
      ' Instantiate the secure string.
      Dim testString As SecureString = New SecureString()
      ' Use the AppendChar method to add each char value to the secure string.
      For Each ch As Char In initString
         testString.AppendChar(ch)
      Next   
      ' Display secure string length.
      Console.WriteLine("The length of the string is {0} characters.", _ 
                        testString.Length)
      testString.Dispose()
   End Sub
End Module
' The example displays the following output:
'      The length of the string is 10 characters.

SecureString(Char*, Int32)

Kaynak:

SecureString.cs

Önemli

Bu API, CLS uyumlu değildir.

Nesnelerin alt dizisinden sınıfının yeni bir örneğini SecureStringChar başlatır.

Bu oluşturucu CLS uyumlu değildir. CLS uyumlu alternatifi şeklindedir SecureString().

public:
 SecureString(char* value, int length);

[System.CLSCompliant(false)]
public SecureString (char* value, int length);

[<System.CLSCompliant(false)>]
new System.Security.SecureString : nativeptr<char> * int -> System.Security.SecureString

Parametreler

value

Char*

Bir nesne dizisi işaretçisi Char .

length

Int32

Yeni örneğe eklenecek öğelerinin value sayısı.

Öznitelikler

CLSCompliantAttribute

Özel durumlar

ArgumentNullException

value, null değeridir.

ArgumentOutOfRangeException

length sıfırdan küçük veya 65.536'dan büyük.

CryptographicException

Bu güvenli dizenin değeri korunurken veya koruması kaldırılırken bir hata oluştu.

NotSupportedException

Bu işlem bu platformda desteklenmiyor.

Örnekler

Aşağıdaki örnek, oluşturucusunu bir karakter dizisine işaretçi geçirerek yeni SecureString bir nesnenin örneğini oluşturur.

using namespace System;
using namespace System::Security;

int main(array<System::String ^> ^args)
{
   SecureString^ testString;
   // Define the string value to assign to a new secure string.
   Char chars[4] = { 't', 'e', 's', 't' };
   // Instantiate a new secure string.
   Char* pChars = &chars[0];

   testString = gcnew SecureString(pChars, sizeof(chars)/sizeof(chars[0]));

   // Display secure string length.
   Console::WriteLine("The length of the string is {0} characters.", 
                        testString->Length);
   delete testString;
   return 0;
}
// The example displays the following output:
//      The length of the string is 4 characters.

using System;
using System.Security;

public class Example
{
   unsafe public static void Main()
   {
      SecureString testString;
      // Define the string value to assign to a new secure string.
      char[] chars = { 't', 'e', 's', 't' };

      // Instantiate a new secure string.
      fixed(char* pChars = chars)
      {
         testString = new SecureString(pChars, chars.Length);
      }
      // Display secure string length.
      Console.WriteLine("The length of the string is {0} characters.", 
                        testString.Length);
      testString.Dispose();
   }
}
// The example displays the following output:
//      The length of the string is 4 characters.

Açıklamalar

Bu oluşturucu yeni SecureString nesneyi tarafından belirtilen lengthkarakter value sayısına başlatır; örneğin değeri daha sonra şifrelenir.

C# dilinde bu oluşturucu yalnızca güvenli olmayan kod bağlamında tanımlanır.