|
//------------------------------------------------------------------------------
// <copyright file="DbgUtil.cs" company="Microsoft">
// Copyright (c) Microsoft Corporation. All rights reserved.
// </copyright>
//------------------------------------------------------------------------------
// SECREVIEW: This is a debug-only library that won't ship with retail builds.
//
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Performance", "CA1801:AvoidUnusedParameters", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.AssertFinalization(System.Object,System.Boolean):System.Void")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Security", "CA2106:SecureAsserts", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.AssertFinalization(System.Object,System.Boolean):System.Void")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Security", "CA2106:SecureAsserts", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.FormatMessage(System.Int32,System.Runtime.InteropServices.HandleRef,System.Int32,System.Int32,System.Text.StringBuilder,System.Int32,System.Runtime.InteropServices.HandleRef):System.Int32")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA902:MovePInvokesToNativeMethodsClass", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.FormatMessage(System.Int32,System.Runtime.InteropServices.HandleRef,System.Int32,System.Int32,System.Text.StringBuilder,System.Int32,System.Runtime.InteropServices.HandleRef):System.Int32")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Security", "CA2101:SpecifyMarshalingForPInvokeStringArguments", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.FormatMessage(System.Int32,System.Runtime.InteropServices.HandleRef,System.Int32,System.Int32,System.Text.StringBuilder,System.Int32,System.Runtime.InteropServices.HandleRef):System.Int32")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Security", "CA2106:SecureAsserts", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.GetLastErrorStr():System.String")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1031:DoNotCatchGeneralExceptionTypes", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.GetLastErrorStr():System.String")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Security", "CA2106:SecureAsserts", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.GetUserDefaultLCID():System.Int32")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA902:MovePInvokesToNativeMethodsClass", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.GetUserDefaultLCID():System.Int32")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Usage", "CA2205:UseManagedEquivalentsOfWin32Api", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.GetUserDefaultLCID():System.Int32")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Security", "CA2106:SecureAsserts", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.IsCriticalException(System.Exception):System.Boolean")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1031:DoNotCatchGeneralExceptionTypes", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.StackFramesToStr(System.Int32):System.String")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Performance", "CA1818:DoNotConcatenateStringsInsideLoops", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.StackFramesToStr(System.Int32):System.String")]
[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Interoperability", "CA1404:CallGetLastErrorImmediatelyAfterPInvoke", Scope="member", Target="System.Windows.Forms.Internal.DbgUtil.GetLastErrorStr():System.String")]
#if Microsoft_NAMESPACE
namespace System.Windows.Forms.Internal
#elif DRAWING_NAMESPACE
namespace System.Drawing.Internal
#else
namespace System.Internal
#endif
{
using System;
using System.Drawing;
using System.Diagnostics;
using System.Diagnostics.CodeAnalysis;
using System.Reflection;
using System.Text;
using System.Runtime.InteropServices;
using System.Security.Permissions;
using System.Globalization;
/// <include file='doc\DbgUtil.uex' path='docs/doc[@for="DbgUtil"]/*' />
/// <devdoc>
/// Debug help utility.
/// </devdoc>
[
ReflectionPermission(SecurityAction.Assert, MemberAccess=true),
EnvironmentPermission(SecurityAction.Assert, Unrestricted=true),
FileIOPermission(SecurityAction.Assert, Unrestricted=true),
SecurityPermission(SecurityAction.Assert, Flags=SecurityPermissionFlag.UnmanagedCode),
UIPermission(SecurityAction.Assert, Unrestricted=true)
]
internal sealed class DbgUtil
{
public const int
FORMAT_MESSAGE_ALLOCATE_BUFFER = 0x00000100,
FORMAT_MESSAGE_IGNORE_INSERTS = 0x00000200,
FORMAT_MESSAGE_FROM_SYSTEM = 0x00001000,
FORMAT_MESSAGE_DEFAULT = FORMAT_MESSAGE_IGNORE_INSERTS | FORMAT_MESSAGE_FROM_SYSTEM;
[DllImport(ExternDll.Kernel32, SetLastError=true, CharSet=System.Runtime.InteropServices.CharSet.Auto)]
public static extern int GetUserDefaultLCID();
[DllImport(ExternDll.Kernel32, SetLastError=true, CharSet=System.Runtime.InteropServices.CharSet.Auto)]
public static extern int FormatMessage(int dwFlags, HandleRef lpSource, int dwMessageId, int dwLanguageId, StringBuilder lpBuffer, int nSize, HandleRef arguments);
public static int gdipInitMaxFrameCount = 8;
// disable csharp compiler warning #0414: field assigned unused value
#pragma warning disable 0414
public static int gdiUseMaxFrameCount = 8;
public static int finalizeMaxFrameCount = 5;
#pragma warning restore 0414
// Methods
/// <devdoc>
/// Call this method from your Dispose(bool) to assert that unmanaged resources has been explicitly disposed.
/// </devdoc>
[Conditional("DEBUG")] // This code will be compiled into the assembly anyways, it is up to the compiler to ignore the call.
public static void AssertFinalization(object obj, bool disposing)
{
#if GDI_FINALIZATION_WATCH
if( disposing || AppDomain.CurrentDomain.IsFinalizingForUnload() )
{
return;
}
try
{
BindingFlags bindingFlags = BindingFlags.NonPublic | BindingFlags.GetField | BindingFlags.Static | BindingFlags.Instance;
FieldInfo allocSiteFld = obj.GetType().GetField("AllocationSite", bindingFlags);
string allocationSite = allocSiteFld != null ? allocSiteFld.GetValue( obj ).ToString() : "<Allocation site unavailable>";
// ignore ojects created by WindowsGraphicsCacheManager.
if( allocationSite.Contains("WindowsGraphicsCacheManager") )
{
return;
}
Debug.Fail("Object Disposed through finalization - it should be explicitly disposed.");
Debug.WriteLine("Allocation stack:\r\n" + allocationSite);
}
catch(Exception ex)
{
try
{
Debug.WriteLine("Exception thrown while trying to get allocation stack: " + ex);
}
catch
{
}
}
#endif
}
/// <devdoc>
/// </devdoc>
[Conditional("DEBUG")]
public static void AssertWin32(bool expression, string message)
{
#if DEBUG
if( !expression )
{
Debug.Fail(message + "\r\nError: " + DbgUtil.GetLastErrorStr());
}
#endif
}
/// <devdoc>
/// </devdoc>
[Conditional("DEBUG")]
public static void AssertWin32(bool expression, string format, object arg1)
{
#if DEBUG
if( !expression )
{
object[] args = new object[]{ arg1 };
AssertWin32Impl( expression, format, args );
}
#endif
}
/// <devdoc>
/// </devdoc>
[Conditional("DEBUG")]
public static void AssertWin32(bool expression, string format, object arg1, object arg2)
{
#if DEBUG
if( !expression )
{
object[] args = new object[]{ arg1, arg2 };
AssertWin32Impl( expression, format, args );
}
#endif
}
/// <devdoc>
/// </devdoc>
[Conditional("DEBUG")]
public static void AssertWin32(bool expression, string format, object arg1, object arg2, object arg3)
{
#if DEBUG
if( !expression )
{
object[] args = new object[]{ arg1, arg2, arg3 };
AssertWin32Impl( expression, format, args );
}
#endif
}
/// <devdoc>
/// </devdoc>
[Conditional("DEBUG")]
public static void AssertWin32(bool expression, string format, object arg1, object arg2, object arg3, object arg4)
{
#if DEBUG
if( !expression )
{
object[] args = new object[]{ arg1, arg2, arg3, arg4 };
AssertWin32Impl( expression, format, args );
}
#endif
}
/// <devdoc>
/// </devdoc>
[Conditional("DEBUG")]
public static void AssertWin32(bool expression, string format, object arg1, object arg2, object arg3, object arg4, object arg5)
{
#if DEBUG
if( !expression )
{
object[] args = new object[]{ arg1, arg2, arg3, arg4, arg5 };
AssertWin32Impl( expression, format, args );
}
#endif
}
/// <devdoc>
/// </devdoc>
[Conditional("DEBUG")] // This code will be compiled into the assembly anyways, it is up to the compiler to ignore the call.
private static void AssertWin32Impl(bool expression, string format, object[] args)
{
#if DEBUG
if( !expression )
{
string message = string.Format(CultureInfo.CurrentCulture, format, args);
Debug.Fail(message + "\r\nError: " + DbgUtil.GetLastErrorStr());
}
#endif
}
//
// WARNING: Your PInvoke function needs to have the DllImport.SetLastError=true for this method
// to work properly. From the MSDN:
// GetLastWin32Error exposes the Win32 GetLastError API method from Kernel32.DLL. This method exists
// because it is not safe to make a direct platform invoke call to GetLastError to obtain this information.
// If you want to access this error code, you must call GetLastWin32Error rather than writing your own
// platform invoke definition for GetLastError and calling it. The common language runtime can make
// internal calls to APIs that overwrite the operating system maintained GetLastError.
//
// You can only use this method to obtain error codes if you apply the System.Runtime.InteropServices.DllImportAttribute
// to the method signature and set the SetLastError field to true.
//
[SuppressMessage("Microsoft.Interoperability", "CA1404:CallGetLastErrorImmediatelyAfterPInvoke")]
public static string GetLastErrorStr()
{
int MAX_SIZE = 255;
StringBuilder buffer = new StringBuilder(MAX_SIZE);
string message = String.Empty;
int err = 0;
try
{
err = Marshal.GetLastWin32Error();
int retVal = FormatMessage(
FORMAT_MESSAGE_DEFAULT,
new HandleRef(null, IntPtr.Zero),
err,
GetUserDefaultLCID(),
buffer,
MAX_SIZE,
new HandleRef(null, IntPtr.Zero) );
message = retVal != 0 ? buffer.ToString() : "<error returned>";
}
catch( Exception ex)
{
if( DbgUtil.IsCriticalException(ex) )
{
throw; //rethrow critical exception.
}
message = ex.ToString();
}
return String.Format( CultureInfo.CurrentCulture, "0x{0:x8} - {1}", err, message);
}
/// <devdoc>
/// Duplicated here from ClientUtils not to depend on that code because this class is to be
/// compiled into System.Drawing and System.Windows.Forms.
/// </devdoc>
private static bool IsCriticalException( Exception ex )
{
return
//ex is NullReferenceException ||
ex is StackOverflowException ||
ex is OutOfMemoryException ||
ex is System.Threading.ThreadAbortException;
}
/// <devdoc>
/// </devdoc>
public static string StackTrace
{
get
{
return Environment.StackTrace;
}
}
/// <devdoc>
/// Returns information about the top stack frames in a string format. The input param determines the number of
/// frames to include.
/// </devdoc>
public static string StackFramesToStr( int maxFrameCount )
{
string trace = String.Empty;
try
{
StackTrace st = new StackTrace( true );
int dbgUtilFrameCount = 0;
//
// Ignore frames for methods on this library.
// Note: The stack frame holds the latest frame at index 0.
//
while( dbgUtilFrameCount < st.FrameCount )
{
StackFrame sf = st.GetFrame(dbgUtilFrameCount);
if( sf == null || sf.GetMethod().DeclaringType != typeof(DbgUtil) )
{
break;
}
dbgUtilFrameCount++;
}
maxFrameCount += dbgUtilFrameCount; // add ignored frames.
if( maxFrameCount > st.FrameCount )
{
maxFrameCount = st.FrameCount;
}
for(int i = dbgUtilFrameCount; i < maxFrameCount; i++ )
{
StackFrame sf = st.GetFrame(i);
if( sf == null )
{
continue;
}
MethodBase mi = sf.GetMethod();
if( mi == null )
{
continue;
}
string args = String.Empty;
string fileName = sf.GetFileName();
int backSlashIndex = fileName == null ? -1 : fileName.LastIndexOf( '\\' );
if( backSlashIndex != -1 )
{
fileName = fileName.Substring( backSlashIndex + 1, fileName.Length - backSlashIndex - 1);
}
foreach( ParameterInfo pi in mi.GetParameters() )
{
args += pi.ParameterType.Name + ", ";
}
if( args.Length > 0 ) // remove last comma.
{
args = args.Substring(0, args.Length - 2);
}
trace += String.Format(CultureInfo.CurrentCulture, "at {0} {1}.{2}({3})\r\n", fileName, mi.DeclaringType, mi.Name, args );
}
}
catch( Exception ex )
{
if( DbgUtil.IsCriticalException(ex) )
{
throw; //rethrow critical exception.
}
trace += ex.ToString();
}
return trace.ToString();
}
/// <devdoc>
/// Returns information about the top stack frames in a string format.
/// </devdoc>
public static string StackFramesToStr()
{
return StackFramesToStr( DbgUtil.gdipInitMaxFrameCount );
}
/// <devdoc>
/// Returns information about the top stack frames in a string format. The input param determines the number of
/// frames to include. The 'message' parameter is used as the header of the returned string.
/// </devdoc>
public static string StackTraceToStr( string message, int frameCount )
{
return String.Format( CultureInfo.CurrentCulture, "{0}\r\nTop Stack Trace:\r\n{1}", message, DbgUtil.StackFramesToStr(frameCount));
}
/// <devdoc>
/// Returns information about the top stack frames in a string format. The 'message' parameter is used as the header of the returned string.
/// </devdoc>
public static string StackTraceToStr( string message )
{
return StackTraceToStr(message, DbgUtil.gdipInitMaxFrameCount );
}
}
}
|