방법: 두 웹 파트 컨트롤 간 정적 연결 선언
업데이트: 2007년 11월
개발자는 페이지 지속성 형식을 통해 연결을 선언하여 두 서버 컨트롤 간에 정적 웹 파트 연결을 만들 수 있습니다. 정적 연결은 선언된 컨트롤처럼 웹 페이지에서 영구 개체가 됩니다. 정적 연결은 공유 개체이므로 모든 사용자가 볼 수 있으며 해당하는 UI(사용자 인터페이스) 옵션이 있는 경우 사용자가 연결을 끊을 수 있지만 연결 개체를 삭제할 수는 없습니다. 모든 사용자가 항상 사용할 수 있는 연결을 설정하지만 사용자가 페이지에서 연결을 삭제하지 못하게 하려는 경우 정적 연결을 선택하는 것이 좋습니다. 연결에 대한 자세한 내용은 WebPartConnection 및 웹 파트 연결 개요를 참조하십시오. 정적 연결에 대한 자세한 내용은 IsStatic을 참조하십시오. 이 항목에서는 두 WebPart 컨트롤 간에 정적 연결을 만드는 방법을 보여 줍니다.
.gif "참고") 참고: |
|---|
이 항목에서는 웹 페이지의 태그에 정적 연결을 선언하는 방법을 중점적으로 보여 줍니다. 두 서버 컨트롤 간에 정적 웹 파트 연결을 선언하려면 해당 컨트롤이 연결을 처리하도록 적절히 디자인되어야 하고 WebPartZoneBase 영역에 컨트롤이 있어야 합니다. 연결에 참여하는 컨트롤의 요구 사항에 대한 자세한 설명은 WebPartConnection을 참조하십시오. 이 항목에서 설명한 정적 연결을 호스팅하는 데 사용된 웹 페이지 및 두 WebPart 컨트롤에 대한 예제 코드를 보려면 IsStatic 속성의 예제 부분을 참조하십시오. |
영역 내에서 서버 컨트롤을 선언하려면
웹 페이지의 본문 섹션 내에서 연결을 포함할 <webpartzone> 요소를 추가하고 영역에 추가하는 서버 컨트롤을 포함할 자식 <zonetemplate> 요소를 추가합니다. 코드는 다음 예제와 같습니다.
<asp:WebPartZone ID="WebPartZone1" > <ZoneTemplate> </ZoneTemplate> </asp:WebPartZone><zonetemplate> 요소의 태그 사이에서 웹 파트 연결의 공급자 컨트롤과 소비자 컨트롤로 사용할 서버 컨트롤을 선언합니다. 이러한 컨트롤은 연결에 참여하도록 디자인되어 있어야 합니다. 다른 서버 컨트롤을 영역에 추가할 수도 있습니다. 이 항목의 앞부분에서 설명했듯이 이 예제에 선언된 컨트롤은 IsStatic 속성의 예제 코드에서 가져옵니다. 서버 컨트롤이 포함된 전체 영역에 대한 코드는 다음과 같습니다.
<asp:WebPartZone ID="WebPartZone1" > <ZoneTemplate> <aspSample:ZipCodeWebPart ID="zip1" Title="ZIP Code Provider" /> <aspSample:WeatherWebPart ID="weather1" Title="ZIP Code Consumer" /> </ZoneTemplate> </asp:WebPartZone>
정적 연결을 선언하려면
웹 페이지에는 웹 파트 컨트롤을 사용하는 페이지에 필요한 <asp:webpartmanager> 요소가 이미 있어야 합니다. <staticconnections> 요소를 <asp:webpartmanager> 요소의 자식으로 추가하여 하나 이상의 선언된 정적 연결을 포함합니다. 코드는 다음 예제와 같습니다.
<asp:WebPartManager ID="mgr" > <StaticConnections> </StaticConnections> </asp:WebPartManager><staticconnections> 요소 내에서 <asp:webpartconnection> 요소를 선언합니다. 연결에 대해 id 및 runat 특성뿐만 아니라 다음과 같은 필수 특성을 지정해야 합니다.
ConsumerID - 연결에서 소비자 컨트롤의 ID를 나타냅니다.
ConsumerConnectionPointID - 연결하는 데 사용된 소비자에서 특수 콜백 메서드의 ID를 나타냅니다. 이 특성은 소비자에 두 개 이상의 연결 지점이 있는 경우에만 필요합니다. 연결 지점에 대한 자세한 내용은 ConnectionPoint를 참조하십시오.
ProviderID - 연결에서 공급자 컨트롤의 ID를 나타냅니다.
ProviderConnectionPointID - 연결하는 데 사용된 공급자에서 특수 콜백 메서드의 ID를 나타냅니다. 이 특성은 공급자에 두 개 이상의 연결 지점이 있는 경우에만 필요합니다.
<asp:webpartmanager> 요소 및 자식 정적 연결에 대한 완성된 코드는 다음 예제와 같습니다.
<asp:WebPartManager ID="mgr" > <StaticConnections> <asp:WebPartConnection ID="conn1" ConsumerConnectionPointID="ZipCodeConsumer" ConsumerID="weather1" ProviderConnectionPointID="ZipCodeProvider" ProviderID="zip1" /> </StaticConnections> </asp:WebPartManager>