CustomTaskPaneCollection.Remove 메서드
CustomTaskPaneCollection에서 지정된 CustomTaskPane을 제거합니다.
네임스페이스: Microsoft.Office.Tools
어셈블리: Microsoft.Office.Tools.Common(Microsoft.Office.Tools.Common.dll)
구문
‘선언
Function Remove ( _
customTaskPane As CustomTaskPane _
) As Boolean
bool Remove(
CustomTaskPane customTaskPane
)
매개 변수
- customTaskPane
형식: Microsoft.Office.Tools.CustomTaskPane
컬렉션에서 제거할 CustomTaskPane입니다.
반환 값
형식: System.Boolean
컬렉션에서 CustomTaskPane이 성공적으로 제거되면 true이고, 지정된 CustomTaskPane이 컬렉션에 포함되어 있지 않으면 false입니다.
예외
예외 | 상황 |
---|---|
ArgumentNullException | customTaskPane는 nullNull 참조(Visual Basic의 경우 Nothing)입니다. |
ObjectDisposedException | CustomTaskPaneCollection을 대상으로 이미 Dispose() 메서드를 호출한 경우 |
설명
추가 기능에서 사용자 지정 작업 창을 더 이상 필요로 하지 않으면 Remove 메서드를 사용하여 추가 기능 실행 중에 작업 창에서 사용된 리소스를 정리할 수 있습니다. 이 메서드를 사용하면 지정된 CustomTaskPane 개체의 Dispose() 메서드가 자동으로 호출됩니다.
Microsoft Visual Studio Tools for Office Runtime에서는 추가 기능이 언로드될 때 사용자 지정 작업 창에서 사용된 리소스를 자동으로 정리합니다. 프로젝트의 ThisAddIn_Shutdown 이벤트 처리기에서 Remove 메서드를 호출하지 마십시오. Microsoft Visual Studio Tools for Office Runtime에서는 ThisAddIn_Shutdown이 호출되기 전에 CustomTaskPane 개체에서 사용된 리소스를 정리하기 때문에 이러한 메서드는 ObjectDisposedException을 throw합니다.
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.