HtmlInputFile.Value Propriedade

Referência

Definição

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém o caminho completo do arquivo no computador do cliente.

public:
 virtual property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
public override string Value { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.Value : string with get, set

Public Overrides Property Value As String

Valor da propriedade

String

O caminho completo do arquivo do cliente.

Atributos: BrowsableAttribute

Exceções

NotSupportedException

Foi feita uma tentativa para atribuir um valor a essa propriedade.

Exemplos

O exemplo de código a seguir demonstra como usar a Value propriedade para exibir o caminho completo do arquivo no computador do cliente. Para que este exemplo funcione corretamente, você precisa criar um diretório chamado Temp na unidade C do computador.

<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Button1_Click(object Source, EventArgs e)
  {

    // Make sure a file was submitted.
    if (Text1.Value == "")
    {
      Span1.InnerHtml = "Error: You must enter a file name.";
      return;
    }

    // Save the file.
    if (File1.PostedFile.ContentLength > 0)
    {
      try
      {

        File1.PostedFile.SaveAs("c:\\temp\\" + Text1.Value);
        Span1.InnerHtml = "<b>" + File1.Value + "</b>" +
                          " uploaded successfully to <b>c:\\temp\\" +
                          Text1.Value + "</b> on the Web server.";

      }
      catch (Exception exc)
      {

        Span1.InnerHtml = "Error saving file <b>c:\\temp\\" +
                          Text1.Value + "</b><br />" + exc.ToString() + ".";

      }
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>HtmlInputFile Example</title>
  </head>

  <body>

    <h3>HtmlInputFile Example</h3>

    <form id="form1" enctype="multipart/form-data" 
          runat="server">
 
       Select File to Upload: 
       <input id="File1" 
              type="file" 
              runat="server" />
 
       <p>
       Save as file name (no path): 
       <input id="Text1" 
              type="text" 
              runat="server" />
 
       </p>
       <p>
       <span id="Span1" 
             style="font: 8pt verdana;" 
             runat="server" />
 
       </p>
       <p>
       <input type="button" 
              id="Button1" 
              value="Upload" 
              onserverclick="Button1_Click" 
              runat="server" />
 
       </p>
    </form>

  </body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Public Sub Button1_Click(ByVal Source As Object, ByVal e As EventArgs)
 
    ' Make sure a file was submitted.
    If Text1.Value = "" Then
 
      Span1.InnerHtml = "Error: You must enter a file name."
      Return

    End If
 
    ' Save the file.
    If File1.PostedFile.ContentLength > 0 Then
         
      Try

        File1.PostedFile.SaveAs("c:\temp\" & Text1.Value)
        Span1.InnerHtml = "<b>" & File1.Value & "</b>" & _
                          " uploaded successfully to <b>c:\temp\" & _
                          Text1.Value & "</b> on the Web server."
      
      Catch exc As Exception
      
        Span1.InnerHtml = "Error saving file <b>c:\temp\" & _
                          Text1.Value & "</b><br />" & exc.ToString() & "."

      End Try

    End If

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>HtmlInputFile Example</title>
  </head>

  <body>

  <h3>HtmlInputFile Example</h3>

    <form id="form1" enctype="multipart/form-data" 
          runat="server">
 
       Select File to Upload: 
       <input id="File1" 
              type="file" 
              runat="server" />
 
       <p>
       Save as file name (no path): 
       <input id="Text1" 
              type="text" 
              runat="server" />
 
       </p>
       <p>
       <span id="Span1" 
             style="font: 8pt verdana;" 
             runat="server" />
 
       </p>
       <p>
       <input type="button" 
              id="Button1" 
              value="Upload" 
              onserverclick="Button1_Click" 
              runat="server" />
 
       </p>
    </form>

  </body>
</html>

Comentários

A Value propriedade recupera o caminho completo do arquivo no computador do cliente (por exemplo, "C:\MyFiles\Test.txt"). Isso é útil quando você precisa saber onde o arquivo está armazenado no computador que está enviando o arquivo. Essa propriedade também é comumente usada para determinar o nome do arquivo original. Para obter o nome do arquivo original, analise o valor dessa propriedade.

Observação

A propriedade Value é somente leitura. Se você tentar atribuir um valor a essa propriedade, um System.NotSupportedException será gerado.

Aplica-se a

Partilhar via