WebPartManager.CloseProviderWarning 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
연결에서 다른 컨트롤에 대해 공급자 역할을 하는 컨트롤을 사용자가 닫을 때 표시되는 경고를 가져오거나 설정합니다.
public:
virtual property System::String ^ CloseProviderWarning { System::String ^ get(); void set(System::String ^ value); };public virtual string CloseProviderWarning { get; set; }member this.CloseProviderWarning : string with get, setPublic Overridable Property CloseProviderWarning As String속성 값
경고 메시지가 들어 있는 문자열입니다. 기본값은 .NET Framework에서 제공하는 문화권별 메시지입니다.
예제
다음 코드 예제에서는 사용자에 게 사용자 지정 경고를 표시 하는 속성을 사용 CloseProviderWarning 하는 방법을 보여 줍니다.
코드 예제에는 다음 네 부분이 있습니다.
웹 파트 페이지의 디스플레이 모드를 변경할 수 있게 해 주는 사용자 정의 컨트롤입니다.
두 개의 사용자 지정 컨트롤과 사용자 지정 WebPart 인터페이스가 포함된 소스 코드 파일입니다.
연결할 수 있는 두 개의 사용자 지정 WebPart 컨트롤과
<asp:webpartmanager>요소가 포함된 웹 페이지입니다.예제가 브라우저에서 작동하는 방식에 대한 설명입니다.
다음 코드에는 예제의 웹 페이지 부분만 포함되어 있습니다. 또한 위에서 언급한 사용자 지정 컨트롤에 대한 사용자 지정 사용자 정의 컨트롤 및 소스 코드가 필요합니다. 클래스 개요의 예제 섹션에서 WebPartManager 이러한 두 항목을 가져옵니다.
다음 웹 페이지 코드는 요소의 선언적 태그에서 속성에 CloseProviderWarning 사용자 지정 경고 메시지를 할당하는 <asp:webpartmanager> 방법을 보여 줍니다.
<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="ConnectionSampleCS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<!-- Reference the WebPartManager control. -->
<asp:WebPartManager ID="WebPartManager1" runat="server"
CloseProviderWarning="You are closing a provider control." />
<div>
<uc1:DisplayModeMenuCS ID="displaymode1" runat="server" />
<!-- Reference consumer and provider controls in a zone. -->
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<aspSample:ZipCodeWebPart ID="zip1"
runat="server"
Title="Zip Code Control"/>
<aspSample:WeatherWebPart ID="weather1"
runat="server"
Title="Weather Control" />
</ZoneTemplate>
</asp:WebPartZone>
<hr />
<!-- Add a ConnectionsZone so users can connect controls. -->
<asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
</div>
</form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="ConnectionSampleVB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<!-- Reference the WebPartManager control. -->
<asp:WebPartManager ID="WebPartManager1" runat="server"
CloseProviderWarning="You are closing a provider control." />
<div>
<uc1:DisplayModeMenuVB ID="displaymode1" runat="server" />
<!-- Reference consumer and provider controls in a zone. -->
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<aspSample:ZipCodeWebPart ID="zip1"
runat="server"
Title="Zip Code Control"/>
<aspSample:WeatherWebPart ID="weather1"
runat="server"
Title="Weather Control" />
</ZoneTemplate>
</asp:WebPartZone>
<hr />
<!-- Add a ConnectionsZone so users can connect controls. -->
<asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
</div>
</form>
</body>
</html>
브라우저에서 웹 페이지를 로드한 후 표시 모드 드롭다운 목록 컨트롤을 클릭하고 커넥트 선택하여 페이지를 연결 모드로 전환합니다. 커넥트 모드에서는 <asp:connectionszone> 요소를 사용하여 컨트롤 간에 연결을 만들 수 있습니다. 연결 모드에서 우편 번호 컨트롤의 제목 표시줄에서 아래쪽 화살표를 클릭하여 동사 메뉴를 활성화한 다음 커넥트 클릭합니다. 연결 UI(사용자 인터페이스)가 나타나면 소비자에 대한 연결 만들기 링크를 클릭합니다. 드롭다운 목록 컨트롤이 있는 셀이 나타납니다. 드롭다운 목록에서 날씨 제어 를 선택하고 커넥트 클릭하여 두 컨트롤의 연결을 완료합니다. 닫기를 클릭한 다음 표시 모드 드롭다운 목록을 사용하여 페이지를 일반 찾아보기 모드로 반환합니다. 마지막으로 우편 번호 컨트롤의 동사 메뉴(이 경우 공급자 컨트롤)를 클릭하고 닫기를 선택합니다. 속성에 CloseProviderWarning 할당한 사용자 지정 메시지가 표시됩니다.
설명
사용자가 컨트롤을 닫으면 WebPart 일반적으로 메시지가 표시되지 않습니다. 컨트롤을 닫는 것이 무엇을 의미하는지에 대한 자세한 내용은 메서드를 CloseWebPart 참조하세요.
그러나 컨트롤이 다른 컨트롤에 연결되어 있고 다른 컨트롤에 대한 데이터 공급자 역할을 하는 경우 사용자가 컨트롤을 닫으려고 할 때 기본 경고 메시지가 표시됩니다. 이 메시지는 공급자 컨트롤이 닫히려고 한다는 것을 사용자에게 알려줍니다. 즉, 소비자가 더 이상 사용할 데이터가 없기 때문에 이 공급자에 연결된 컨트롤이 없습니다. 이 CloseProviderWarning 속성을 사용하면 개발자가 사용자에게 표시되는 경고 메시지를 사용자 지정할 수 있습니다.
페이지 개발자가 이 속성에 빈 문자열 또는 null 문자열 값을 할당하는 경우 사용자가 공급자인 컨트롤을 닫 WebPart 을 때 경고 메시지 상자가 표시되지 않습니다.