internal (C#-Referenz)

  • Artikel

Das Schlüsselwort internal ist ein Zugriffsmodifizierer für Typen und Typmember.

Auf dieser Seite wird der Zugriff auf internal behandelt. Das Schlüsselwort internal ist auch Teil des Zugriffsmodifizierers protected internal.

Auf interne Typen oder Member kann nur innerhalb einer Datei in derselben Assembly zugegriffen werden, so wie in diesem Beispiel:

public class BaseClass
{  
    // Only accessible within the same assembly.
    internal static int x = 0;
}

Einen Vergleich von internal mit den anderen Zugriffsmodifizierern finden Sie unter Zugriffsebenen und Zugriffsmodifizierer.

Eine assembly ist eine ausführbare oder DLL (Dynamic Link Library), die aus der Kompilierung einer oder mehrerer Quelldateien erstellt wird.

Weitere Informationen zu Assemblys finden Sie unter Assemblys in .NET.

Ein interner Zugriff wird häufig bei komponentenbasierten Entwicklungen verwendet, da auf diese Weise Gruppen von Komponenten privat kooperieren können, ohne dass sie für den Rest des Anwendungscodes verfügbar gemacht werden. Ein Framework könnte z.B für das Erstellen grafischer Benutzeroberflächen Control- und Form-Klassen zur Verfügung stellen, die kooperieren, indem sie Member mit internen Zugriff verwenden. Da diese Member intern sind, werden sie nicht für Code verfügbar gemacht, der das Framework verwendet.

Es ist unzulässig, auf einen Typen oder einen Member mit internem Zugriff außerhalb der Assembly zu verweisen, in der sie definiert wurden.

Beispiel 1

Dieses Beispiel enthält zwei Dateien, Assembly1.cs und Assembly1_a.cs. Die erste Datei enthält eine interne Basisklasse, BaseClass. In der zweiten Datei führt der Versuch, BaseClass zu instanziieren zu einem Fehler.

// Assembly1.cs  
// Compile with: /target:library  
internal class BaseClass
{  
   public static int intM = 0;  
}  

// Assembly1_a.cs  
// Compile with: /reference:Assembly1.dll  
class TestAccess
{  
   static void Main()
   {  
      var myBase = new BaseClass();   // CS0122  
   }  
}

Beispiel 2

Verwenden Sie in diesem Beispiel dieselbe Datei, die Sie im ersten Beispiel verwendet haben, und ändern Sie die Zugriffsebene von BaseClass in public. Ändern Sie außerdem die Zugriffsebene des Members intM in internal. Jetzt können Sie die Klasse instanziieren, aber Sie können nicht auf den internen Member zugreifen.

// Assembly2.cs  
// Compile with: /target:library  
public class BaseClass
{  
   internal static int intM = 0;  
}  

// Assembly2_a.cs  
// Compile with: /reference:Assembly2.dll  
public class TestAccess
{  
   static void Main()
   {  
      var myBase = new BaseClass();   // Ok.  
      BaseClass.intM = 444;    // CS0117  
   }  
}

C#-Programmiersprachenspezifikation

Weitere Informationen finden Sie unter Deklarierte Barrierefreiheit in der C#-Sprachspezifikation. Die Sprachspezifikation ist die verbindliche Quelle für die Syntax und Verwendung von C#.

Siehe auch