COMException Sınıf

Tanım

Bir COM yöntem çağrısından tanınmayan HRESULT döndürüldüğünde oluşturulan özel durum.The exception that is thrown when an unrecognized HRESULT is returned from a COM method call.

public ref class COMException : Exception
public ref class COMException : System::Runtime::InteropServices::ExternalException
public class COMException : Exception
public class COMException : System.Runtime.InteropServices.ExternalException
[System.Serializable]
public class COMException : System.Runtime.InteropServices.ExternalException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class COMException : System.Runtime.InteropServices.ExternalException
type COMException = class
    inherit Exception
type COMException = class
    inherit ExternalException
[<System.Serializable>]
type COMException = class
    inherit ExternalException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type COMException = class
    inherit ExternalException
Public Class COMException
Inherits Exception
Public Class COMException
Inherits ExternalException
Devralma
COMException
Devralma
Türetilmiş
Öznitelikler

Açıklamalar

Ortak dil çalışma zamanı, iyi bilinen HRESULTs 'leri .NET Framework özel durumlara dönüştürür ve COM nesnelerinin yönetilen istemcilere anlamlı hata bilgileri döndürmesini sağlar.The common language runtime transforms well-known HRESULTs to .NET Framework exceptions, enabling COM objects to return meaningful error information to managed clients. HRESULT için özel durum eşleme, yönetilmeyen istemcilere belirli HRESULTs döndürme yoluyla da diğer yönde de kullanılabilir.The HRESULT to exception mapping also works in the other direction by returning specific HRESULTs to unmanaged clients. Eşleme ayrıntıları için bkz. nasıl yapılır: harita HRESULTs ve Exceptions.For mapping details, see How to: Map HRESULTs and Exceptions.

Çalışma zamanı tanıdık bir HRESULT (özel, karşılık gelen özel durumu olmayan bir HRESULT) ile karşılaştığında, sınıfının bir örneğini oluşturur COMException .When the runtime encounters an unfamiliar HRESULT (an HRESULT that lacks a specific, corresponding exception), it throws an instance of the COMException class. Bu bir bütün amaç özel durumu, tüm özel durumlar için aynı üyeleri gösterir ve ErrorCode Aranan tarafından döndürülen HRESULT 'yi içeren bir ortak özelliği devralır.This all-purpose exception exposes the same members as any exception, and inherits a public ErrorCode property that contains the HRESULT returned by the callee. Çalışma zamanı için bir hata iletisi varsa ( IErrorInfo arabiriminden veya Err Visual Basic içindeki nesneden elde edilen veya işletim sisteminden bazı durumlarda), ileti çağırana döndürülür.If an error message is available to the runtime (obtained from the IErrorInfo interface or the Err object in Visual Basic, or in some cases from the operating system), the message is returned to the caller. Ancak, COM Bileşen geliştiricisi bir hata iletisi içermiyorsa, çalışma zamanı bir ileti dizesinin yerine sekiz basamaklı HRESULT döndürür.However, if the COM component developer fails to include an error message, the runtime returns the eight-digit HRESULT in place of a message string. HRESULT olması, çağıranın genel özel durumun nedenini belirlemesine izin verir.Having an HRESULT allows the caller to determine the cause of the generic exception.

COMException özel durumunu işlemeHandling a COMException exception

Aşağıda, özel durum sorunlarını gidermeye yönelik bazı noktalar verilmiştir COMException .The following are some considerations for troubleshooting a COMException exception.

Özelliği denetleyin ErrorCodeCheck the ErrorCode property
Çalışma zamanı tanıdık bir HRESULT ile karşılaştığında ve bir COMException özel durum oluşturduğunda, ErrorCode özellik hata iletisini ya da bir hata mesajı yoksa sekız basamaklı HRESULT değerini içerir.When the runtime encounters an unfamiliar HRESULT and throws a COMException exception, the ErrorCode property includes either the error message or, if an error message is unavailable, the eight-digit HRESULT value. Hata iletisi veya HRESULT değeri özel durumun nedenini belirlemenize yardımcı olabilir.The error message or the HRESULT value can help you determine the cause of the exception.

HRESULT değerlerinin listesi için bkz. genel HRESULT değerleri.For a list of HRESULT values, see Common HRESULT Values.

Geç bağlantılı bağımsız değişkenler ve Microsoft Office nesnelerLate-bound arguments and Microsoft Office objects
Microsoft Office nesnelerinin yöntemlerine geç bağlantılı bağımsız değişkenler geçirirken, COMException nesneler com nesneleri olduğunda bir özel durum oluşturulabilir.When passing late-bound arguments to methods of Microsoft Office objects, a COMException exception may be thrown when the objects are COM objects. En geç bağlayıcı, bu tür yöntemin bir parametre içerdiği ByRef ve geçirdiğiniz özelliğin bir erişimcisi olduğunu varsayar set .The late binder assumes that such method calls involve a ByRef parameter and that the property you pass has a set accessor. Özelliği değilse .NET Framework bir MissingMethodException özel durum oluşturur ( CORE_E_MISSINGMETHOD HRESULT ile).If the property does not, the .NET Framework generates a MissingMethodException exception (with a CORE_E_MISSINGMETHOD HRESULT ). Bu davranışı geçici olarak çözmek için, bir nesnenin özelliği yerine erken bağlantılı nesneleri kullanın veya bir değişken geçirin.To work around this behavior, use early-bound objects or pass a variable instead of a property of the object.

Visual Studio ve barındırma işlemiVisual Studio and the hosting process
COM, Visual Studio ile barındırma işlemiarasında iletişim kurmak için kullanılır.COM is used to communicate between Visual Studio and the hosting process. Kod çalıştırılmadan önce kullanıldığından, CoInitializeSecurity çağrısı bu özel durumun oluşturulmasına neden olur.Because it is used before code runs, a call to CoInitializeSecurity causes this exception to be thrown.

Bazı durumlarda, Visual Studio 'Yu yönetici olarak çalıştırmak sorunu çözebilir.In some cases, running Visual Studio as Administrator may resolve the issue. Barındırma sürecini de devre dışıbırakabilirsiniz.You can also disable the hosting process.

COMException özel durumu oluşturuluyorThrowing a COMException exception

COMExceptionSınıfı, belirli HRESULTs 'leri yönetilmeyen istemcilere döndürmek için kullanabilseniz de, belirli bir .NET Framework özel durumu oluşturmak genel bir özel durum kullanmaktan daha iyidir.Although you can use the COMException class to return specific HRESULTs to unmanaged clients, throwing a specific .NET Framework exception is better than using a generic exception. Yönetilen istemcilerin ve yönetilmeyen istemcilerin .NET Framework nesneniz kullanmasını ve yönetilen bir çağırana HRESULT bir özel durum oluşturmaktan daha az anlama dahil olduğunu göz önünde bulundurun.Consider that managed clients as well as unmanaged clients can use your .NET Framework object, and throwing an HRESULT to a managed caller is less comprehensible than throwing an exception.

Oluşturucular

COMException()

COMException sınıfının yeni bir örneğini varsayılan değerlerle başlatır.Initializes a new instance of the COMException class with default values.

COMException(SerializationInfo, StreamingContext)

Serileştirme verilerinden sınıfının yeni bir örneğini başlatır COMException .Initializes a new instance of the COMException class from serialization data.

COMException(String)

Belirtilen iletiyle sınıfının yeni bir örneğini başlatır COMException .Initializes a new instance of the COMException class with a specified message.

COMException(String, Exception)

COMExceptionBelirtilen bir hata iletisiyle sınıfın yeni bir örneğini ve bu özel durumun nedeni olan iç özel duruma bir başvuruyu başlatır.Initializes a new instance of the COMException class with a specified error message and a reference to the inner exception that is the cause of this exception.

COMException(String, Int32)

COMExceptionBelirtilen bir ileti ve hata kodu ile sınıfın yeni bir örneğini başlatır.Initializes a new instance of the COMException class with a specified message and error code.

Özellikler

Data

Özel durum hakkında ek kullanıcı tanımlı bilgiler sağlayan anahtar/değer çiftleri koleksiyonunu alır.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Devralındığı yer: Exception)
ErrorCode

Hatayı alır HRESULT .Gets the HRESULT of the error.

(Devralındığı yer: ExternalException)
HelpLink

Bu özel durumla ilişkili Yardım dosyasının bağlantısını alır veya ayarlar.Gets or sets a link to the help file associated with this exception.

(Devralındığı yer: Exception)
HResult

Belirli bir özel duruma atanan kodlanmış bir sayısal değer olan HRESULT 'yi alır veya ayarlar.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Devralındığı yer: Exception)
InnerException

ExceptionGeçerli özel duruma neden olan örneği alır.Gets the Exception instance that caused the current exception.

(Devralındığı yer: Exception)
Message

Geçerli özel durumu açıklayan bir ileti alır.Gets a message that describes the current exception.

(Devralındığı yer: Exception)
Source

Uygulamanın veya hataya neden olan nesnenin adını alır veya ayarlar.Gets or sets the name of the application or the object that causes the error.

(Devralındığı yer: Exception)
StackTrace

Çağrı yığınında anlık çerçevelerin dize gösterimini alır.Gets a string representation of the immediate frames on the call stack.

(Devralındığı yer: Exception)
TargetSite

Geçerli özel durumu oluşturan yöntemi alır.Gets the method that throws the current exception.

(Devralındığı yer: Exception)

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetBaseException()

Türetilmiş bir sınıfta geçersiz kılınırsa, Exception bir veya daha fazla sonraki özel durumun kök nedeni olan öğesini döndürür.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Devralındığı yer: Exception)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)

Türetilmiş bir sınıfta geçersiz kılınırsa, SerializationInfo özel durum hakkındaki bilgileri ayarlar.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Devralındığı yer: Exception)
GetType()

Geçerli örneğin çalışma zamanı türünü alır.Gets the runtime type of the current instance.

(Devralındığı yer: Exception)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
ToString()

Özel durumun içeriğini bir dizeye dönüştürür.Converts the contents of the exception to a string.

ToString()

Geçerli özel durumun dize gösterimini oluşturur ve döndürür.Creates and returns a string representation of the current exception.

(Devralındığı yer: Exception)

Ekinlikler

SerializeObjectState

Özel durum hakkında serileştirilmiş veri içeren bir özel durum nesnesi oluşturmak için bir özel durum serileştirildiğinde gerçekleşir.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Devralındığı yer: Exception)

Şunlara uygulanır

Ayrıca bkz.