This documentation is archived and is not being maintained.

InvalidProjectFileException Class

This exception is thrown whenever there is a problem with the user's XML project file. The problem might be semantic or syntactical. The latter would be of a type typically caught by XSD validation (if it was performed by the project writer).


Namespace:  Microsoft.Build.Exceptions
Assembly:  Microsoft.Build (in Microsoft.Build.dll)

public sealed class InvalidProjectFileException : Exception

The InvalidProjectFileException type exposes the following members.

Public methodInvalidProjectFileException()Default constructor.
Public methodInvalidProjectFileException(String)Creates an instance of this exception using the specified error message.
Public methodInvalidProjectFileException(String, Exception)Creates an instance of this exception using the specified error message and inner exception.
Public methodInvalidProjectFileException(String, Int32, Int32, Int32, Int32, String, String, String, String)Creates an instance of this exception using rich error information.

Public propertyBaseMessageGets the exception message not including the project file.
Public propertyColumnNumberGets the invalid column number (if any) in the project.
Public propertyDataGets a collection of key/value pairs that provide additional user-defined information about the exception. (Inherited from Exception.)
Public propertyEndColumnNumberGets the last column number (if any) of a range of invalid columns in the project.
Public propertyEndLineNumberGets the last line number (if any) of a range of invalid lines in the project.
Public propertyErrorCodeGets the error code (if any) associated with the exception message.
Public propertyErrorSubcategoryGets the error sub-category (if any) that describes the type of this error.
Public propertyHasBeenLoggedGets a flag that determines whether the exception has already been logged. Allows the exception to be logged at the most appropriate location, but continue to be propagated.
Public propertyHelpKeywordGets the F1-help keyword (if any) associated with this error, for the host IDE.
Public propertyHelpLinkGets or sets a link to the help file associated with this exception. (Inherited from Exception.)
Protected propertyHResultGets or sets HRESULT, a coded numerical value that is assigned to a specific exception. (Inherited from Exception.)
Public propertyInnerExceptionGets the Exception instance that caused the current exception. (Inherited from Exception.)
Public propertyLineNumberGets the invalid line number (if any) in the project.
Public propertyMessageGets the exception message including the affected project file (if any). (Overrides Exception.Message.)
Public propertyProjectFileGets the file (if any) associated with this exception. This may be an imported file.
Public propertySourceGets or sets the name of the application or the object that causes the error. (Inherited from Exception.)
Public propertyStackTraceGets a string representation of the immediate frames on the call stack. (Inherited from Exception.)
Public propertyTargetSiteGets the method that throws the current exception. (Inherited from Exception.)

Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetBaseExceptionWhen overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions. (Inherited from Exception.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetObjectDataISerializable method which we must override since Exception implements this interface If we ever add new members to this class, we'll need to update this. (Overrides Exception.GetObjectData(SerializationInfo, StreamingContext).)
Public methodGetTypeGets the runtime type of the current instance. (Inherited from Exception.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringCreates and returns a string representation of the current exception. (Inherited from Exception.)

Protected eventSerializeObjectStateOccurs when an exception is serialized to create an exception state object that contains serialized data about the exception. (Inherited from Exception.)

WARNING: marking a type [Serializable] without implementing ISerializable imposes a serialization contract -- it is a promise to never change the type's fields i.e. the type is immutable; adding new fields in the next version of the type without following certain special FX guidelines, can break both forward and backward compatibility

.NET Framework

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.