Image.FromFile Metodo

Definizione

Crea un oggetto Image dal file specificato.

Overload

FromFile(String)

Crea un oggetto Image dal file specificato.

FromFile(String, Boolean)

Crea un oggetto Image dal file specificato, usando le informazioni relative alla gestione colori incorporate nel file.

FromFile(String)

Origine:
Image.cs
Origine:
Image.cs
Origine:
Image.cs

Crea un oggetto Image dal file specificato.

C#
public static System.Drawing.Image FromFile (string filename);

Parametri

filename
String

Stringa contenente il nome del file da cui creare l'oggetto Image.

Restituisce

Oggetto Image creato da questo metodo.

Eccezioni

Il formato immagine del file non è valido.

-oppure-

GDI+ non supporta il formato pixel del file.

Il file specificato non esiste.

filename è un oggetto Uri.

Esempio

Nell'esempio di codice seguente viene illustrato come usare i FromFileGetPropertyItem metodi e SetPropertyItem . Questo esempio è progettato per essere usato con Windows Forms. Per eseguire questo esempio, incollarlo in un modulo e gestire l'evento del Paint modulo chiamando il DemonstratePropertyItem metodo, passando e come PaintEventArgs.

C#
private void DemonstratePropertyItem(PaintEventArgs e)
{

    // Create two images.
    Image image1 = Image.FromFile("c:\\FakePhoto1.jpg");
    Image image2 = Image.FromFile("c:\\FakePhoto2.jpg");

    // Get a PropertyItem from image1.
    PropertyItem propItem = image1.GetPropertyItem(20624);

    // Change the ID of the PropertyItem.
    propItem.Id = 20625;

    // Set the PropertyItem for image2.
    image2.SetPropertyItem(propItem);

    // Draw the image.
    e.Graphics.DrawImage(image2, 20.0F, 20.0F);
}

Commenti

Managed GDI+ include codificatori e decodificatori predefiniti che supportano i tipi di file seguenti:

  • BMP

  • GIF

  • JPEG

  • PNG

  • TIFF

Il file rimane bloccato finché non Image viene eliminato.

Se il file non ha un formato di immagine valido o se GDI+ non supporta il formato pixel del file, questo metodo genera un'eccezione OutOfMemoryException .

Nota

La Image classe non supporta la trasparenza alfa nelle bitmap. Per abilitare la trasparenza alfa, usare immagini PNG con 32 bit per pixel.

Vedi anche

Si applica a

.NET Framework 4.8.1 e altre versioni
Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

FromFile(String, Boolean)

Origine:
Image.cs
Origine:
Image.cs
Origine:
Image.cs

Crea un oggetto Image dal file specificato, usando le informazioni relative alla gestione colori incorporate nel file.

C#
public static System.Drawing.Image FromFile (string filename, bool useEmbeddedColorManagement);

Parametri

filename
String

Stringa contenente il nome del file da cui creare l'oggetto Image.

useEmbeddedColorManagement
Boolean

Impostare su true per usare le informazioni sulla gestione colori incorporate nel file di immagine; in caso contrario, impostare su false.

Restituisce

Oggetto Image creato da questo metodo.

Eccezioni

Il formato immagine del file non è valido.

-oppure-

GDI+ non supporta il formato pixel del file.

Il file specificato non esiste.

filename è un oggetto Uri.

Esempio

Nell'esempio di codice seguente viene illustrato come ottenere una nuova bitmap usando il FromFile metodo . Illustra anche un TextureBrushoggetto .

Questo esempio è progettato per essere usato con Windows Forms. Create un modulo contenente un pulsante denominato Button2. Incollare il codice nel modulo e associare il Button2_Click metodo all'evento del Click pulsante.

C#
private void Button2_Click(System.Object sender, System.EventArgs e)
{
    try
    {
        Bitmap image1 = (Bitmap) Image.FromFile(@"C:\Documents and Settings\" +
            @"All Users\Documents\My Music\music.bmp", true);

        TextureBrush texture = new TextureBrush(image1);
        texture.WrapMode = System.Drawing.Drawing2D.WrapMode.Tile;
        Graphics formGraphics = this.CreateGraphics();
        formGraphics.FillEllipse(texture, 
            new RectangleF(90.0F, 110.0F, 100, 100));
        formGraphics.Dispose();
    }
    catch(System.IO.FileNotFoundException)
    {
        MessageBox.Show("There was an error opening the bitmap." +
            "Please check the path.");
    }
}

Commenti

Managed GDI+ include codificatori e decodificatori predefiniti che supportano i tipi di file seguenti:

  • BMP

  • GIF

  • JPEG

  • PNG

  • TIFF

Se il file non ha un formato di immagine valido o se GDI+ non supporta il formato pixel del file, questo metodo genera un'eccezione OutOfMemoryException .

Il file rimane bloccato finché non Image viene eliminato.

Il useEmbeddedColorManagement parametro specifica se la nuova Image correzione del colore viene applicata in base alle informazioni di gestione dei colori incorporate nel file di immagine. Le informazioni incorporate possono includere profili International Color Consortium (ICC), valori gamma e informazioni sulla cromaticità.

Nota

La Image classe non supporta la trasparenza alfa nelle bitmap. Per abilitare la trasparenza alfa, usare immagini PNG con 32 bit per pixel.

Vedi anche

Si applica a

.NET Framework 4.8.1 e altre versioni
Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9