Using 項目 (CSDL)

發行項
12/10/2012

概念結構定義語言 (CSDL) 中的 Using 項目可匯入於不同命名空間中存在之概念模型的內容。經由設定 Namespace 屬性的值，您可以參考於其他概念模型中定義的實體類型、複雜型別和關聯類型。Schema 項目的子項目可以是一個以上的 Using 項目。

注意

CSDL 中之 Using 項目的功能，與程式語言中的 using 陳述式不完全相同。經由匯入命名空間和程式語言的 using 陳述式，您不會影響原始命名空間中的物件。在 CSDL 中，匯入的命名空間可以包含實體類型，該實體類型是衍生自原始命名空間中的實體類型。這會影響在原始命名空間中宣告的實體集。如需實體集的詳細資訊，請參閱 EntitySet 項目。

Using 項目可以擁有下列子項目：

Documentation (可允許零或一個項目)
Annotation 項目 (可允許零或多個項目)

適用屬性

下表描述可套用至 Using 項目的屬性。

屬性名稱	必要	值
Namespace	有	匯入的命名空間名稱。
Alias	是	用來取代命名空間名稱的識別項。雖然這個屬性是必要的，但是不必使用此屬性取代命名空間名稱，來限定物件名稱。

注意

任何數量的附註屬性 (自訂 XML 屬性) 都可以套用至 Using 項目。不過，自訂屬性不可屬於任何 XML 命名空間，這是保留供 CSDL 使用。任兩個自訂屬性的完整名稱不能相同。

範例

下列範例示範匯入於他處定義之命名空間的 Using 項目。請注意， Schema 項目的命名空間會在 BooksModel 顯示。PublisherEntityType 上的 Address 屬性是複雜型別，於 ExtendedBooksModel 命名空間 (使用 Using 項目匯入) 定義。

      <Schema xmlns="https://schemas.microsoft.com/ado/2008/09/edm"
              xmlns:cg="https://schemas.microsoft.com/ado/2006/04/codegeneration"
              xmlns:store="https://schemas.microsoft.com/ado/2007/12/edm/EntityStoreSchemaGenerator"
              Namespace="BooksModel" Alias="Self">

        <Using Namespace="BooksModel.Extended" Alias="BMExt" />

    <EntityContainer Name="BooksContainer" >
          <EntitySet Name="Publishers" EntityType="BooksModel.Publisher" />
        </EntityContainer>

    <EntityType Name="Publisher">
          <Key>
            <PropertyRef Name="Id" />
          </Key>
          <Property Type="Int32" Name="Id" Nullable="false" />
          <Property Type="String" Name="Name" Nullable="false" />
          <Property Type="BMExt.Address" Name="Address" Nullable="false" />
        </EntityType>

    </Schema>