WebPartChrome.GetWebPartVerbs(WebPart) 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

WebPart 컨트롤을 사용하여 렌더링할 동사의 컬렉션을 가져옵니다.

protected:
 virtual System::Web::UI::WebControls::WebParts::WebPartVerbCollection ^ GetWebPartVerbs(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);

protected virtual System.Web.UI.WebControls.WebParts.WebPartVerbCollection GetWebPartVerbs (System.Web.UI.WebControls.WebParts.WebPart webPart);

abstract member GetWebPartVerbs : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPartVerbCollection
override this.GetWebPartVerbs : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPartVerbCollection

Protected Overridable Function GetWebPartVerbs (webPart As WebPart) As WebPartVerbCollection

매개 변수

webPart

WebPart

현재 렌더링되고 있는 컨트롤입니다.

반환

WebPartVerbCollection

webPart로 렌더링할 모든 동사가 포함된 WebPartVerbCollection입니다.

예외

ArgumentNullException

webPart이(가) null인 경우

예제

다음 코드 예제에서는 사용 하는 방법을 보여 줍니다는 GetWebPartVerbs 메서드입니다. 예제를 실행 하는 데 필요한 전체 코드의 예제 섹션을 참조 하세요.를 WebPartChrome 클래스 개요 항목입니다.

코드 예제의 다음 섹션에서는 메서드를 재정의 GetWebPartVerbs 하는 방법을 보여 줍니다. 재정의된 메서드는 기본 메서드를 사용하여 컨트롤에서 webPart 모든 동사를 검색한 다음 동사 컬렉션을 반복하여 개체에 가까운 동사를 제외한 모든 동사를 ArrayList 추가합니다. 그러면 이 축소된 동사 집합이 호출자에게 반환되는 새 WebPartVerbCollection에 할당됩니다.

protected override WebPartVerbCollection GetWebPartVerbs(WebPart webPart)
{
  ArrayList verbSet = new ArrayList();
  foreach (WebPartVerb verb in base.GetWebPartVerbs(webPart))
  {
    if (verb.Text != "Close")
      verbSet.Add(verb);
  }
  WebPartVerbCollection reducedVerbSet = 
    new WebPartVerbCollection(verbSet);
  return reducedVerbSet;
}

Protected Overrides Function GetWebPartVerbs _
  (ByVal webPart As WebPart) As WebPartVerbCollection

  Dim verbSet As New ArrayList()
  Dim verb As WebPartVerb
  For Each verb In MyBase.GetWebPartVerbs(webPart)
    If verb.Text <> "Close" Then
      verbSet.Add(verb)
    End If
  Next verb

  Dim reducedVerbSet As WebPartVerbCollection = _
    New WebPartVerbCollection(verbSet)

  Return reducedVerbSet
End Function

브라우저에서 웹 페이지를 로드하고 각 WebPart 컨트롤의 동사 메뉴(제목 표시줄에 아래쪽 화살표로 표시됨)를 클릭하면 닫기 동사가 컨트롤에 대해 렌더링되지 않는 것을 볼 수 있습니다.

설명

이 메서드는 GetWebPartVerbs 개발자에게 메서드를 재정의하고 특정 동사가 렌더링되지 않도록 제외할 수 있는 기회를 제공합니다. 이는 동사가 렌더링되는 것을 제외할 FilterWebPartVerbs 수도 있는 메서드와 비슷합니다.

그러나 GetWebPartVerbs 메서드는 동사를 렌더링할지 여부를 결정하기 위해 일부 조건을 확인하려는 경우를 위한 것이 아닙니다. 대신, 이 메서드는 특정 동사를 항상 제외하려는 미리 알고 있는 경우에 유용합니다. 예를 들어 사용자 지정 WebPartChrome 클래스를 개발하는 경우 사용자가 컨트롤을 닫을 수 없도록 컨트롤에서 WebPart 닫기 동사를 항상 제외하도록 결정할 수 있습니다. 모든 컨트롤에서 AllowClose 속성을 false 로 설정하는 대신 메서드를 재정 GetWebPartVerbs 의하고 사용자 지정 WebPartChrome 개체로 렌더링된 컨트롤 WebPart 에서 가까운 동사를 렌더링하지 않도록 제외할 수 있습니다.

추가 정보

• ASP.NET 웹 파트 컨트롤