mcs/docs/ecma334/8.12.xml

   1 <?xml version="1.0"?>
   2 <clause number="8.12" title="Namespaces and assemblies" informative="true">
   3   <paragraph>The programs presented so far have stood on their own except for dependence on a few system-provided classes such as System.Console. It is far more common, however, for real-world applications to consist of several different pieces, each compiled separately. For example, a corporate application might depend on several different components, including some developed internally and some purchased from independent software vendors. </paragraph>
   4   <paragraph>Namespaces and assemblies enable this component-based system. Namespaces provide a logical organizational system. Namespaces are used both as an &quot;internal&quot; organization system for a program, and as an &quot;external&quot; organization system-a way of presenting program elements that are exposed to other programs. </paragraph>
   5   <paragraph>Assemblies are used for physical packaging and deployment. An assembly may contain types, the executable code used to implement these types, and references to other assemblies. </paragraph>
   6   <paragraph>To demonstrate the use of namespaces and assemblies, this section revisits the &quot;hello, world&quot; program presented earlier, and splits it into two pieces: a class library that provides messages and a console application that displays them. </paragraph>
   7   <paragraph>The class library will contain a single class named HelloMessage. The example <code_example><![CDATA[
   8 // HelloLibrary.cs
   9 namespace CSharp.Introduction
  10 {
  11    public class HelloMessage
  12    {
  13       public string Message {
  14          get {
  15             return "hello, world";
  16          }
  17       }
  18    }
  19 }
  20 ]]></code_example>shows the HelloMessage class in a namespace named CSharp.Introduction. The HelloMessage class provides a read-only property named Message. Namespaces can nest, and the declaration <code_example><![CDATA[
  21 namespace CSharp.Introduction
  22 {...}
  23 ]]></code_example>is shorthand for two levels of namespace nesting: <code_example><![CDATA[
  24 namespace CSharp
  25 {
  26    namespace Introduction
  27    {...}
  28 }
  29 ]]></code_example></paragraph>
  30   <paragraph>The next step in the componentization of &quot;hello, world&quot; is to write a console application that uses the HelloMessage class. The fully qualified name for the  class-CSharp.Introduction.HelloMessage-could be used, but this name is quite long and unwieldy. An easier way is to use a using namespace directive, which makes it possible to use all of the types in a namespace without qualification. The example <code_example><![CDATA[
  31 // HelloApp.cs
  32 using CSharp.Introduction;
  33 class HelloApp
  34 {
  35    static void Main() {
  36       HelloMessage m = new HelloMessage();
  37       System.Console.WriteLine(m.Message);
  38    }
  39 }
  40 ]]></code_example>shows a using namespace directive that refers to the CSharp.Introduction namespace. The occurrences of HelloMessage are shorthand for CSharp.Introduction.HelloMessage. </paragraph>
  41   <paragraph>C# also enables the definition and use of aliases. A using alias directive defines an alias for a type. Such aliases can be useful in situation in which name collisions occur between two class libraries, or when a small number of types from a much larger namespace are being used. The example <code_example><![CDATA[
  42 using MessageSource = CSharp.Introduction.HelloMessage;
  43 ]]></code_example>shows a using alias directive that defines MessageSource as an alias for the HelloMessage class. </paragraph>
  44   <paragraph>The code we have written can be compiled into a class library containing the class HelloMessage and an application containing the class HelloApp. The details of this compilation step might differ based on the compiler or tool being used. A command-line compiler might enable compilation of a class library and an application that uses that library with the following command-line invocations: <code_example><![CDATA[
  45 csc /target:library HelloLibrary.cs
  46 csc /reference:HelloLibrary.dll HelloApp.cs
  47 ]]></code_example>which produce a class library named HelloLibrary.dll and an application named HelloApp.exe. </paragraph>
  48 </clause>