FromFile Method (GraphicsDevice, String)

Texture2D.FromFile Method (GraphicsDevice, String)

This method is available only when developing for Windows.
Creates a texture resource from a file.

Namespace: Microsoft.Xna.Framework.Graphics
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)

public static Texture2D FromFile (
         GraphicsDevice graphicsDevice,
         string filename


The graphics device to use to create the texture resource.
The name of the file containing the texture.

Return Value

The texture resource that has been created on the specified graphics device.

Exception typeCondition
ArgumentException filename is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
ArgumentNullException filename is null.
PathTooLongExceptionThe specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
DirectoryNotFoundExceptionThe specified path is invalid (for example, it is on an unmapped drive).
UnauthorizedAccessException The filename parameter specifies a directory, or the caller does not have the required permission to access the file specified by filename.
FileNotFoundException The file specified in filename was not found.
NotSupportedException filename is in an invalid format.

The supported texture image file formats are described by the ImageFileFormat enumeration.

Windows XP SP2, Windows Vista

Community Additions

© 2016 Microsoft