다음을 통해 공유

웹 파트 컨트롤 설명 파일

  • 아티클

업데이트: 2007년 11월

웹 파트 컨트롤 설명 파일에는 WebPart 컨트롤 또는 웹 파트 응용 프로그램에 사용되는 다른 ASP.NET 서버 컨트롤이나 사용자 정의 컨트롤에서 확장명이 .WebPart인 XML 파일로 내보낸 속성 값, 상태 데이터, 어셈블리 또는 소스 파일이 포함됩니다. 설명 파일은 웹 파트에서 설명하는 컨트롤을 웹 파트 페이지로 가져오고, 저장된 데이터로 이 컨트롤을 구성하기 위해 웹 파트 가져오기 기능에서 사용됩니다. 이 항목에서는 설명 파일의 기본 구조 및 파일에 포함된 XML 요소에 대해 설명합니다.

<webParts>
  <webPart>
    <metaData>
      <type …/>
      <importErrorMessage …/>
    </metadata>
    <data>
      <properties>
        <ipersonalizable>
          <property …/>
        </ipersonalizable>
        <property …/>
      </properties>
      <genericWebPartProperties>
        <ipersonalizable>
          <property …/>
        </ipersonalizable>
        <property …/>
      </genericWebPartProperties>
    </data>
  </webPart>
</webParts>

설명

다음 표에서는 웹 파트 설명 파일에 포함될 수 있는 각 요소(각 요소 아래에 해당 요소의 직계 자식 요소가 들여쓰기되어 있음)와 해당 요소에 있는 특성을 보여 주고 각 요소의 용도를 요약하여 설명합니다. 컨트롤이 IPersonalizable 인터페이스를 구현하는 경우에는 해당 <ipersonalizable> 자식 요소가 나타나고 구현된 속성을 <property> 요소로 포함합니다. 그렇지 않은 경우에는 <ipersonalizable> 요소가 파일에 나타나지 않습니다.

요소

특성

요약

webParts

  webPart

없음

파일에서 부모 요소이며 파일마다 한 번씩 나올 수 있습니다. XML 논리에 따르면 각 파일마다 이 요소에 <webPart> 요소를 여러 개 포함할 수 있지만 현재 구현에서는 설명 파일에 <webPart>가 하나 있습니다.

webPart

  metaData

  data

xmlns="https://schemas.microsoft.com/WebPart/v3"

참고:
이 특성은 고정 값을 사용하는 네임스페이스 특성입니다.

해당 상태 및 속성 데이터가 파일에 포함되는 컨트롤을 나타냅니다. 현재 각 파일마다 <webPart> 요소가 하나만 포함될 수 있습니다.

metaData

  type

  importErrorMessage

없음

<webPart> 요소의 형식 정보와 가져오는 동안 오류가 발생할 경우 사용자에게 표시할 메시지를 포함합니다. <webPart> 요소 당 인스턴스 하나를 사용할 수 있습니다.

type

type 요소에는 name 또는 src 특성 중 하나를 지정해야 하며 둘 다 지정할 수도 있습니다. 두 특성을 모두 지정하는 경우 name 특성의 우선 순위가 높습니다.

name 특성의 값은 <webPart> 요소에 대한 형식과 어셈블리 정보(옵션)가 포함된 문자열로 구성됩니다.

src 특성은 사용자 정의 컨트롤의 소스 파일 경로를 제공합니다.

<webPart> 요소를 포함하는 어셈블리의 형식 정보를 나열하거나, <webPart>가 사용자 정의 컨트롤을 나타낼 경우에는 소스 파일 경로를 나열합니다. <webPart> 요소 당 인스턴스 하나를 사용할 수 있습니다.

importErrorMessage

없음

가져오는 동안 오류가 발생할 경우 사용자에게 표시되는 메시지 텍스트를 포함합니다. <webPart> 요소 당 인스턴스 하나를 사용할 수 있습니다.

data

  properties

  genericWebPartProperties

없음

<webPart> 요소에 대한 상태 및 속성 값 데이터를 포함합니다. <webPart> 요소 당 인스턴스 하나를 사용할 수 있습니다.

properties

  ipersonalizable

  property

없음

<property> 요소, 단일 <ipersonalizable> 요소(자식 <property> 요소 포함) 또는 둘 다 포함합니다. <properties> 요소는 항상 있지만 <webPart>에 개인 설정 가능한 속성이 있는 경우에만 자식 <property> 요소를 가집니다. <webPart> 요소 당 인스턴스 하나를 사용할 수 있습니다.

genericWebPartProperties

  ipersonalizable

  property

없음

<property> 요소, 단일 <ipersonalizable> 요소(자식 <property> 요소 포함) 또는 둘 다 포함합니다. 이 요소는 <webPart>에 해당하는 컨트롤이 WebPart 클래스에서 상속되지 않는 경우에만 제공됩니다. <webPart> 요소 당 인스턴스 하나를 사용할 수 있습니다.

ipersonalizable

  property

없음

<properties> 요소와 <genericWebPartProperties> 요소 둘 다의 자식입니다. 이 요소는 <webPart> 요소에 해당하는 컨트롤이 IPersonalizable 인터페이스를 구현하는 경우에만 나타납니다. 이 요소에는 하나 이상의 <property> 요소가 포함됩니다. <webPart> 요소 당 인스턴스 하나를 사용할 수 있습니다.

property

property 요소에는 name, type 및 null이라는 세 가지 특성이 있습니다. name 특성과 type 특성은 필수적 요소이고 null은 속성에 null 값이 있는 경우에만 사용됩니다.

name 특성은 <webPart> 요소에 해당하는 컨트롤의 특정 속성에 대한 이름입니다.

null 특성은 true 또는 false 값을 가질 수 있으며 속성에 실제로 null 값이 있는 경우 빈 문자열("") 값과 구별하기 위해 사용됩니다.

type 특성은 name 특성에서 참조되는 속성의 Type을 식별합니다. type의 실제 값은 정규화된 형식 이름을 포함하는 문자열 또는 아래 나열된 약식 형식 이름 중 하나를 사용하는 문자열이 될 수 있습니다.

* string

* int

* bool

* double

* single

* datetime

* color

* unit

* fontsize

* object

* direction(ContentDirection을 나타냄)

* helpmode(WebPartHelpMode를 나타냄)

* chromestate(PartChromeState를 나타냄)

* chrometype(PartChromeType을 나타냄)

* exportmode(WebPartExportMode를 나타냄)

<properties>, <genericWebPartProperties> 및 <ipersonalizable> 요소의 자식입니다. 이 요소에는 <webPart> 요소 내의 각 속성 값 또는 상태 데이터 항목에 대한 이름/값 쌍이 포함됩니다. 속성의 실제 데이터는 <property> 요소 태그 사이에 포함되고 속성 항목의 이름과 형식은 특성에 지정됩니다. 이 요소를 포함하는 부모 요소의 세 가지 형식 내에 <property> 요소가 하나도 포함되지 않거나 여러 개 포함될 수 있습니다.

예제

다음 코드 예제에서는 웹 파트 응용 프로그램의 여러 컨트롤 인스턴스에서 내보낸 .WebPart 설명 파일 두 개를 보여 줍니다. 첫 번째 예제에서는 기본 WebPart 클래스에서 상속되는 컨트롤에 대한 파일을 보여 줍니다. 이때 속성 데이터가 모두 <properties> 섹션에 포함되어 있습니다. 두 번째 예제에서는 WebPart 클래스에서 상속되지 않는 ASP.NET 서버 컨트롤에 대한 파일을 보여 줍니다. 이때 속성 데이터가 모두 <genericWebPartProperties> 섹션에 포함되어 있습니다.

<!-- File exported from a System.Web.UI.WebControls.WebParts.WebPart 
     control. -->
<?xml version="1.0" encoding="utf-8"?>
<webParts>
  <webPart xmlns="https://schemas.microsoft.com/WebPart/v3">
    <metaData>
      <type name="Samples.AspNet.CS.Controls.TextDisplayWebPart, 
        App_Code.zq0cecf5, Version=0.0.0.0, Culture=neutral, 
        PublicKeyToken=null" />
      <importErrorMessage>
        Cannot import this Web Parts control.
      </importErrorMessage>
    </metaData>
    <data>
      <properties>
        <property name="AllowClose" type="bool">True</property>
        <property name="Width" type="unit" />
        <property name="AllowMinimize" type="bool">True</property>
        <property name="ContentText" type="string" null="true" />
        <property name="AllowConnect" type="bool">True</property>
        <property name="ChromeType" type="chrometype">
          Default
        </property>
        <property name="TitleIconImageUrl" type="string" />
        <property name="Description" type="string" />
        <property name="Hidden" type="bool">False</property>
        <property name="TitleUrl" type="string" />
        <property name="AllowEdit" type="bool">True</property>
        <property name="Height" type="unit" />
        <property name="HelpUrl" type="string" />
        <property name="Title" type="string" />
        <property name="CatalogIconImageUrl" type="string" />
        <property name="Direction" type="direction">
          NotSet
        </property>
        <property name="ChromeState" type="chromestate">
          Normal
        </property>
        <property name="AllowZoneChange" type="bool">True</property>
        <property name="AllowHide" type="bool">True</property>
        <property name="HelpMode" type="helpmode">Navigate</property>
        <property name="ExportMode" type="exportmode">All</property>
      </properties>
    </data>
  </webPart>
</webParts>

<!-- File exported from a System.Web.UI.WebControls.BulletedList 
     control placed in a Web Parts zone. -->
<?xml version="1.0" encoding="utf-8"?>
<webParts>
  <webPart xmlns="https://schemas.microsoft.com/WebPart/v3">
    <metaData>
      <type name="System.Web.UI.WebControls.BulletedList, 
        System.Web, Version=2.0.0.0, Culture=neutral, 
        PublicKeyToken=b03f5f7f11d50a3a" />
      <importErrorMessage>
        Cannot import this Web Parts control.
      </importErrorMessage>
    </metaData>
    <data>
      <properties />
      <genericWebPartProperties>
        <property name="AllowClose" type="bool">True</property>
        <property name="Width" type="unit" />
        <property name="AllowMinimize" type="bool">True</property>
        <property name="AllowConnect" type="bool">True</property>
        <property name="ChromeType" type="chrometype">
          Default
        </property>
        <property name="TitleIconImageUrl" type="string" />
        <property name="Description" type="string" />
        <property name="Hidden" type="bool">False</property>
        <property name="TitleUrl" type="string" />
        <property name="AllowEdit" type="bool">True</property>
        <property name="Height" type="unit" />
        <property name="HelpUrl" type="string" />
        <property name="Title" type="string">
          Favorite Links
        </property>
        <property name="CatalogIconImageUrl" type="string" />
        <property name="Direction" type="direction">
          NotSet
        </property>
        <property name="ChromeState" type="chromestate">
          Normal
        </property>
        <property name="AllowZoneChange" type="bool">
          True
        </property>
        <property name="AllowHide" type="bool">True</property>
        <property name="HelpMode" type="helpmode">
          Navigate
        </property>
        <property name="ExportMode" type="exportmode">
          All
        </property>
      </genericWebPartProperties>
    </data>
  </webPart>
</webParts>

참고 항목

참조

ExportWebPart

ImportWebPart

ExportMode

ImportCatalogPart