삭제 패턴

https://docs.microsoft.com/ko-kr/dotnet/standard/design-guidelines/dispose-pattern

모든 프로그램 실행을 사용 하는 동안 메모리, 시스템 핸들 또는 데이터베이스 연결과 같은 하나 이상의 시스템 리소스를 획득합니다. 개발자가 직접 획득 고 사용한 후 해제 되어야 합니다 때문에 이러한 시스템 리소스를 사용할 때는 주의 해야 해야 합니다.

CLR 자동 메모리 관리에 대 한 지원을 제공합니다. 관리 되는 메모리 (C# 연산자를 사용 하 여 할당 된 메모리 new) 명시적으로 해제 될 필요가 없습니다. 가비지 수집기 (GC)에 의해 자동으로 해제 됩니다. 이 개발자의 메모리를 확보 걸리고 어려운 작업에서 해제 하 고 되었으면.NET Framework에서 제공 하는 최고의 생산성에 대 한 주된 이유 중 하나입니다.

그러나 관리 되는 메모리는 많은 시스템 리소스 종류 중 하나일 뿐입니다. 리소스 관리 되는 메모리는 여전히 명시적으로 해제 해야 하 고 관리 되지 않는 리소스로 간주 됩니다. GC 특별히 설계 되지 않았습니다 같은 관리 되지 않는 리소스를 관리 하는 개발자가 직접 관리 되지 않는 리소스를 관리 하기 위한 책임은는 의미입니다.

CLR에서 관리 되지 않는 리소스를 해제에 대 한 도움을 제공 합니다. System.Object가상 메서드를 선언 Finalize (종료자 라고도 함) GC가 호출 되 해당 개체의 메모리 GC 회수 하 고 관리 되지 않는 리소스를 해제 하기 위해 재정의할 수 있습니다. 종료자를 재정의 하는 형식 종료 가능 형식으로 참조 됩니다.

종료자 일부 정리 시나리오에서는 유효 하지만, 두 가지 중요 한 단점이 있습니다.

• 종료자는 GC 검색 개체 컬렉션에 적합 한 경우 호출 됩니다. 이 일부 지정 하지 않은 후 일정 시간 동안 리소스가 더 이상 필요 하지 않은 경우에 발생 합니다. 개발자 수 또는 종료자에서 리소스는 실제로 해제 되는 시점 시간과 리소스를 해제 하려는 경우 사이의 지연 또는 많은 부족 한 리소스 (쉽게 소진 될 수 있는 리소스)를 획득 하는 프로그램에서 사용할 수 수 있습니다. 리소스를 사용 하 여 (예:: 관리 되지 않는 대용량 메모리 버퍼)에 유지 하려면 비용이 많이 드는 경우입니다.

• CLR을 종료자를 호출 해야 하는 경우에 다음 가비지 컬렉션 (컬렉션 간에 실행 종료자)의 반올림 될 때까지 개체의 메모리의 컬렉션을 연기 해야 합니다. 이 해당 개체의 메모리 (및 참조 하는 모든 개체) 긴 시간 동안 해제 되지 것을 의미 합니다.

따라서 종료자에만 의존 하지 않을 수 또는 매우 높은 성능의 시나리오에 부족 한 리소스를 처리할 때 가능한 신속 하 게 관리 되지 않는 리소스를 회수 하는 경우 대부분의 시나리오에서 적절 한 추가 된 GC 오버 헤드 종료가 허용 되지 않습니다.

프레임 워크를 제공는 System.IDisposable 인터페이스를 개발자에 게 필요 하지 않은으로 관리 되지 않는 리소스를 해제 하는 수동 방법을 제공 하기 위해 구현 해야 합니다. 또한 제공 된 GC.SuppressFinalize 것을 알 수 GC 개체 수동으로 삭제 된 메서드와 경우 개체의 메모리를 회수할 수 이전 종료 더 이상 필요 하지 않습니다. 구현 하는 형식에서 IDisposable 인터페이스는 삭제 가능한 형식은 라고 합니다.

Dispose 패턴 표준화 사용량과 종료자의 구현 하기 위한 것이 고 IDisposable 인터페이스입니다.

패턴에 대 한 주요 목표는 구현의 복잡성을 줄이기 위해는 Finalize 및 Dispose 메서드. 메서드 (차이점은 장의 뒷부분에 나오는 설명 참조)에 대 한 일부는 아니지만 일부 코드 경로 공유 하는 사실에서 복잡 한 형태소 분석 합니다. 또한 결정적 리소스 관리에 대 한 언어 지원의 진화와 관련 된 패턴의 일부 요소에 대 한 이유 때문에 있습니다.

✓ 않습니다 삭제 가능한 형식은의 인스턴스를 포함 하는 형식에 기본 Dispose 패턴을 구현 합니다. 참조는 기본 Dispose 패턴 기본 패턴에 대 한 자세한 내용은 섹션.

형식이 다른 삭제 가능한 개체의 수명을 담당 이면 개발자 너무을 삭제 하는 방법을 해야 합니다. 컨테이너의를 사용 하 여 Dispose 메서드는 가능 하도록 하는 편리한 방법입니다.

✓ 않습니다 기본 Dispose 패턴을 구현 하 고 보유 중인 리소스를 명시적으로 해제 해야 하 고 종료자가 없는 형식에 종료자를 제공 합니다.

예를 들어 관리 되지 않는 메모리 버퍼를 저장 하는 형식에 패턴을 구현 되어야 합니다. 종료 가능 형식 섹션 종료자를 구현 하는 데 관련 된 지침에 설명 합니다.

✓ 고려 클래스에 직접 저장 하지 않으므로 관리 되지 않는 리소스 또는 삭제 가능한 개체 이지만 수행 하는 하위 종류가 가능성은 기본 Dispose 패턴을 구현 합니다.

이 예는는 System.IO.Stream 클래스입니다. 모든 리소스를 차지 하지 않는 하는 추상 기본 클래스는 아니지만 대부분의 하위 클래스 및이 때문에이 패턴 구현 합니다.

기본 삭제 패턴

구현 패턴의 기본 구현에서는 System.IDisposable 를 선언 하는 인터페이스는 Dispose(bool) 를 간에 공유할 수 있는 모든 리소스 정리 논리를 구현 하는 메서드는 Dispose 메서드와 선택적 종료 자가 있습니다.

다음 예제에서는 기본 패턴의 간단한 구현을 보여 줍니다.

public class DisposableResourceHolder : IDisposable {  

    private SafeHandle resource; // handle to a resource  

    public DisposableResourceHolder(){  
        this.resource = ... // allocates the resource  
    }  

    public void Dispose(){  
        Dispose(true);  
        GC.SuppressFinalize(this);  
    }  

    protected virtual void Dispose(bool disposing){  
        if (disposing){  
            if (resource!= null) resource.Dispose();  
        }  
    }  
}  

부울 매개 변수 disposing 에서 메서드가 호출 된 있는지 여부를 나타내는 IDisposable.Dispose 구현 또는 종료자에서 합니다. Dispose(bool) 구현 다른 참조 개체 (예: 앞의 예제에서 리소스 필드)에 액세스 하기 전에 매개 변수를 확인 해야 합니다. 이러한 개체에서 메서드를 호출할 때에 액세스 해야는 IDisposable.Dispose 구현 (때는 disposing 매개 변수는 true). 메서드가 종료자를 호출 하는 경우 (disposing 은 false), 다른 개체에 액세스할 수 없습니다. 이유는 개체를 순서에 관계 없이 종료 되므로 또는 해당 종속성 수 이미 종료 되었을 합니다.

또한이 섹션으로 이미 Dispose 패턴을 구현 하지 않는 기본 클래스에 적용 됩니다. 이미의 패턴을 구현 하는 클래스에서 상속 하는 경우 재정의 하기만 Dispose(bool)메서드를 추가 하는 리소스 정리 논리를 제공 합니다.

✓ 않습니다 보호 된 가상 void 선언 Dispose(bool disposing) 관련 된 모든 논리를 중앙 집중화 메서드 관리 되지 않는 리소스를 해제 합니다.

이 방법에서는 모든 리소스 정리를 수행 합니다. 메서드는 모두 종료자에서 및 IDisposable.Dispose 메서드. 매개 변수는 종료 자가 내에서 호출 되는 경우 false 됩니다. 종료 하는 동안 실행 되는 모든 코드에는 다른 종료 가능 개체에 액세스 하는 데 사용할 해야 합니다. 종료자를 구현 세부 정보는 다음 섹션에 설명 되어 있습니다.

protected virtual void Dispose(bool disposing){  
    if (disposing){  
        if (resource!= null) resource.Dispose();  
    }  
}  

✓ 않습니다 구현는 IDisposable 단순히 호출 하 여 인터페이스 Dispose(true) 이어서 GC.SuppressFinalize(this)합니다.

에 대 한 호출 SuppressFinalize 경우에 발생 해야 Dispose(true) 성공적으로 실행 합니다.

public void Dispose(){  
    Dispose(true);  
    GC.SuppressFinalize(this);  
}  

X 하지 않으면 매개 변수가 없는 확인 Dispose 가상 메서드.

Dispose(bool) 메서드는 서브 클래스에서 재정의 해야 합니다.

// bad design  
public class DisposableResourceHolder : IDisposable {  
    public virtual void Dispose(){ ... }  
    protected virtual void Dispose(bool disposing){ ... }  
}  

// good design  
public class DisposableResourceHolder : IDisposable {  
    public void Dispose(){ ... }  
    protected virtual void Dispose(bool disposing){ ... }  
}  

X 하지 마십시오 모든 오버 로드의 선언 된 Dispose 이외의 다른 방법 Dispose() 및 Dispose(bool)합니다.

Dispose이 패턴을 체계화 하 고 구현자, 사용자 및 컴파일러 간에 혼동을 방지 하려면 예약 된 단어를 고려 되어야 합니다. 일부 언어 특정 형식에 자동으로이 패턴을 구현 하도록 선택할 수 있습니다.

✓ 않습니다 허용 된 Dispose(bool) 메서드를 두 번 이상 호출할 수 있습니다. 메서드는 아무것도 수행 하지 않는 첫 번째 호출 이후의 수도 있습니다.

public class DisposableResourceHolder : IDisposable {  

    bool disposed = false;  

    protected virtual void Dispose(bool disposing){  
        if(disposed) return;  
        // cleanup  
        ...  
        disposed = true;  
    }  
}  

하지 말고 X 내에서 예외를 throw Dispose(bool) 포함 하는 프로세스 손상 되어 중요 한 상황에 따라 제외 하 고 (누수, 일치 하지 않는 공유 상태 등.).

사용자가 기대 하는에 대 한 호출 Dispose 예외가 발생 하지 것입니다.

경우 Dispose 예외를 발생 시킬 수 있습니다, finally 블록 정리 논리를 더 이상 실행 되지 것입니다. 이 해결 하려면 사용자를 호출할 때마다 래핑할 해야 Dispose(내는 finally 블록!) try 블록에 있는 까지로 매우 복잡 한 정리 처리기입니다. 실행 하는 경우는 Dispose(bool disposing) 메서드를 삭제 하는 것이 false 예외가 throw 되지 않습니다. 이렇게 종료자 컨텍스트 내에서 실행 하는 경우 프로세스가 종료 됩니다.

✓ 않습니다 throw 한 ObjectDisposedException 개체의 삭제 된 후에 사용할 수 없는 멤버에서.

public class DisposableResourceHolder : IDisposable {  
    bool disposed = false;  
    SafeHandle resource; // handle to a resource  

    public void DoSomething(){  
           if(disposed) throw new ObjectDisposedException(...);  
        // now call some native methods using the resource   
            ...  
    }  
    protected virtual void Dispose(bool disposing){  
        if(disposed) return;  
        // cleanup  
        ...  
        disposed = true;  
    }  
}  

✓ 고려 메서드를 제공 하 Close(), 외에 Dispose(), 영역에서 표준 용어 닫기 인지 합니다.

이렇게 할 경우 반드시 귀하에 게는 Close 구현 동일 Dispose 구현는 IDisposable.Dispose 메서드 명시적으로 합니다.

public class Stream : IDisposable {  
    IDisposable.Dispose(){  
        Close();  
    }  
    public void Close(){  
        Dispose(true);  
        GC.SuppressFinalize(this);  
    }  
}  

종료 가능 형식

종료 가능한 형식은 종료자를 재정의 하 고 종료 코드 경로에서 제공 하 여 기본 Dispose 패턴을 확장 하는 형식을 Dispose(bool) 메서드.

종료자는 주로 없기 때문에 시스템의 상태에 대 한 특정 (일반적으로 유효) 가정을 실행 과정을 올바르게 구현 하기 매우 어렵습니다. 다음 지침 신중 하 게 고려를 고려해 야 합니다.

일부 지침 방금에 적용 된 Finalize 메서드를 종료자에서 호출 되는 코드에 있지만 합니다. 기본적인 Dispose 패턴 이전에 정의 된 경우 내에서 실행 하는 논리 Dispose(bool disposing) 때는 disposing 매개 변수는 false입니다.

재정의 하지 않아야 함 기본 클래스는 이미은 종료 가능 하 고 기본 Dispose 패턴을 구현 경우 Finalize 다시 합니다. 재정의 해야 하는 대신 방금는 Dispose(bool)메서드를 추가 하는 리소스 정리 논리를 제공 합니다.

다음 코드에서는 종료 가능 형식의 예제를 보여 줍니다.

public class ComplexResourceHolder : IDisposable {  

    private IntPtr buffer; // unmanaged memory buffer  
    private SafeHandle resource; // disposable handle to a resource  

    public ComplexResourceHolder(){  
        this.buffer = ... // allocates memory  
        this.resource = ... // allocates the resource  
    }  

    protected virtual void Dispose(bool disposing){  
            ReleaseBuffer(buffer); // release unmanaged memory  
        if (disposing){ // release other disposable objects  
            if (resource!= null) resource.Dispose();  
        }  
    }  

    ~ ComplexResourceHolder(){  
        Dispose(false);  
    }  

    public void Dispose(){  
        Dispose(true);  
        GC.SuppressFinalize(this);  
    }  
}  

하지 말고 X 유형을 종료 가능 만드는 합니다.

종료 자가 필요한 생각 하는 모든 경우를 신중히 고려 합니다. 실제는 한 성능 및 코드 복잡성 관점에서 종료자를 사용 하 여 인스턴스와 관련 된 비용입니다. 와 같은 리소스 래퍼를 사용 하는 것을 선호 SafeHandle 가능한 경우에 관리 되지 않는 리소스를 캡슐화, 하는 경우 종료자 불필요 하 게 만드는 자체 리소스 정리에 대 한 래퍼입니다.

X 하지 않으면 값 형식을 개체로 확인 합니다.

실제로 참조 형식에만 CLR에 의해 종료 가져오기 및 값 형식에 종료자를 배치 하려고 하므로 무시 됩니다. C# 및 c + + 컴파일러에서이 규칙을 적용 합니다.

✓ 않습니다 형식이 자체 종료 자가 없는 관리 되지 않는 리소스를 해제 하는 일을 담당 하는 경우 종료 가능 형식을 확인 합니다.

종료자를 구현 하는 경우 호출 Dispose(false) 내 모든 리소스 정리 논리를 배치 하 고는 Dispose(bool disposing) 메서드.

public class ComplexResourceHolder : IDisposable {  

    ~ ComplexResourceHolder(){  
        Dispose(false);  
    }  

    protected virtual void Dispose(bool disposing){  
        ...  
    }  
}  

✓ 않습니다 줄어드는 경우 모든 형식에 대해 기본 Dispose 패턴을 구현 합니다.

이렇게 하면 형식의 사용자를 명시적으로 종료 자가 담당 이러한 동일한 리소스의 명확한 정리 작업을 수행할 수 있습니다.

X 하지 않으면 는 것은 이미 종료 되었을 상당한 위험 있기 때문에 종료 자가 코드 경로에 추가 된 줄어드는 경우 개체에 액세스 합니다.

예를 들어 다른 줄어드는 경우 개체 B에 대 한 참조가 있는 종료 가능 개체가 A 안정적으로에 사용할 수 없습니다 B A의 종료 자가 또는 그 반대의 경우도 마찬가지입니다. 종료자 (보다 짧은 중요 한 종료에 대 한 약한 정렬 보증) 임의의 순서로 호출 됩니다.

또한, 응용 프로그램 도메인 언로드 동안 또는 프로세스를 종료 하는 동안 정적 변수에 저장 된 개체의 특정 지점에서 수집 가져오기 주의 합니다. 종료 가능 개체 (또는 정적 변수에 저장 된 값을 사용할 수 있는 정적 메서드 호출)를 참조 하는 정적 변수가 되지 않을 수 있습니다에 액세스할 경우에 안전 하 게 보호 Environment.HasShutdownStarted true를 반환 합니다.

✓ 않습니다 확인 프로그램 Finalize 보호 된 메서드에 있습니다.

C#, c + +, 및 VB.NET 개발자 필요가 없습니다 이런, 컴파일러는이 지침을 적용 하는 데 도움이 되므로 합니다.

X 하지 않으면 종료자 논리 시스템에 중요 한 오류를 제외 하 고 답변된 예외 이스케이프 합니다.

예외가 종료자에서를 CLR 종료 됩니다 (현재.NET Framework 버전 2.0)에서는 전체 프로세스를 실행 및 제어 된 방식으로 해제 되지 리소스에서 다른 종료자를 방지 합니다.

✓ 고려 만들고 중요 한 종료 가능 개체를 사용 하 여 (포함 된 형식 계층 구조와 형식을 CriticalFinalizerObject)는 종료자 절대적으로 실행 해야 경우에 강제 응용 프로그램 도메인 언로드 및 스레드 상황에 대 한 중단합니다.

일부 © 2005, 2009 Microsoft Corporation. 모든 권리 보유.

피어슨 교육, Inc.에서의 사용 권한으로 재인쇄 Framework 디자인 지침: 규칙, 특징 및 다시 사용할 수 있는.NET 라이브러리를 2nd Edition에 대 한 패턴 Krzysztof Cwalina 및 Brad Abrams 게시 하 여 2008 년 10 월 22 일 Microsoft Windows 개발 시리즈의 일부로: Addison Wesley Professional.