ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Yöntem

Tanım

Ad Alanı:

System.Runtime.ExceptionServices

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

ExceptionDispatchInfo.cs

Sağlanan yığın izlemesini belirtilen Exception örnekte depolar.

public:
 static Exception ^ SetRemoteStackTrace(Exception ^ source, System::String ^ stackTrace);

public static Exception SetRemoteStackTrace(Exception source, string stackTrace);

static member SetRemoteStackTrace : Exception * string -> Exception

Public Shared Function SetRemoteStackTrace (source As Exception, stackTrace As String) As Exception

Parametreler

source

Exception

Kaş çatmayan özel durum.

stackTrace

String

içinde sourcekalıcı olacak yığın izleme dizesi. Bu normalde uzak özel durum örneğinin StackTrace özelliğinden alınır.

Döndürülenler

Exception

Özel source durum örneği.

Özel durumlar

ArgumentNullException

source veya stackTrace bağımsız değişkeni oldunull.

InvalidOperationException

Bağımsız source değişken daha önce oluşturuldu veya daha önce içinde bir yığın izlemesi depolanıyordu.

Açıklamalar

Bu yöntem, özelliği rastgele bir dize değerinden StackTrace doldurur. Tipik kullanım örneği, özel durum nesnesinin Exception yığın izleme bilgilerinin korunmasına olanak sağlayan, yüksek güvenilirlikli işlemler arasında nesnelerin iletilmesidir. .NET, sağlanan dize değerini ayrıştırmaya çalışmaz.

Gerekirse, arayan satır sonlarını kurallı hale getirmeden sorumludur. ReplaceLineEndings() satır sonlarını kurallı hale getirmek için kullanılabilir.

Çağıran bu API'ye güvenilmeyen giriş sağlıyorsa, bu durum özel durumun yığın izlemesinin eklenmiş null karakterler, ayrılmış HTML veya JSON karakterleri ya da diğer beklenmeyen değerler içermesine neden olabilir. Kullanıcıya özel durumun ayrıntılarını görüntüleyen uygulamalar, özel durum bilgilerini her zaman görüntülendiği noktada kodlamaya özen göstermelidir.